Project Setup

Create a New Project

To create a new DaVinci Adaptive project, proceed as follows:

1. New Project
2. Open the menu path File|New|Project.... The New Project wizard opens.
2. Select a wizard
3. On the Select a wizard page, select the wizard DaVinci Adaptive| Create DaVinci Adaptive Project.
4. Click [Next >] to confirm your selection.
3. Basic Settings
4. On the Basic Settings page, the general settings are defined.
5. You can specify as follows:
• Project Name: Enter the name of the project to be created.
• Location: Specify the path to your project.
• Create .gitignore File: In case you are using Git for version control, you can activate this checkbox to create a pre-filled .gitignore file. The created .gitignore file can then be edited using context menu command Edit .gitignore File of your DaVinci Adaptive project in the DaVinci Project Explorer.
• Project Folders:
• Model: This folder contains the AUTOSAR model files, i.e. the ARXML files. By default, this folder is named arxml. Enter the name of the Model folder or use the default name.
• Scripts: This folder contains the automation scripts that are specific for this project. By default, this folder is named scripts. Enter the name of the Scripts folder or use the default name.
6. Click [Next >] to confirm your settings.
4. DaVinci Adaptive Project
5. On the DaVinci Adaptive Project page, you can configure DaVinci Adaptive projects that will be referenced by this project. The selection is optional and can also be done afterwards.
6. If required, activate the check box of the projects to be referenced.
7. Click [Next >] to confirm your settings.
5. Imports
6. On the Imports page, you can specify the files to be imported into you DaVinci Adaptive project. The selection is optional and can also be done afterwards.
7. If required, activate the check box Copy AUTOSAR Standard Types into project.
   If you want to copy external files (e.g. ARXML files) or folders into your project, click Add Files or Add Folder to add them.
   To remove added files, click the Remove icon.
8. Click [Finish] to create the DaVinci Adaptive project and to close the wizard.

The DaVinci Adaptive project has been created.

For a comprehensive guide on setting up a DaVinci Adaptive project, refer to the Getting Started cheat sheet.

Import an Existing Project

To import an existing DaVinci Adaptive project, proceed as follows:

1. Open the menu path File | Import.... The Import wizard opens.
2. Select
3. On the Select page, select the wizard DaVinci Adaptive | Import DaVinci Adaptive Projects.
4. Click [Next >] to confirm your selection.
3. Import DaVinci Adaptive Projects
4. On the Import DaVinci Adaptive Projects page, the projects to be imported and the settings are specified.
5. The following import options are provided:
• Select root directory
  Active the Select root directory option and click the [Browse...] button and navigate to the root directory in which to search for existing projects. The DaVinci Adaptive projects found in that root directory are then displayed and selectable in the Projects area.
• Select archive file
  Active the Select archive file option and click the [Browse...] button and navigate to the archive in which to search for existing projects. The DaVinci Adaptive projects found in that archive file are then displayed and selectable in the Projects area.
6. In the Projects area, select the project(s) to be imported.
7. In the Options area, you can select the following options by activating the corresponding check box:
• Auto import referenced projects
  Activate this option if all referenced projects (including transitive referenced projects) should be imported as well. If a referenced project cannot be found, the user will be asked to specify a location where to search for the referenced project explicitly.
• Search for nested projects
  Activate this option to include nested projects in the search result as well. The search result in the Projects area is automatically updated if this option is activated after the search has already been performed.
  If an archive file is imported, this option is not available.
• Copy projects into workspace
  Activate this option if you want that a copy of the selected project(s) is created instead of referencing the origin location(s).
  If an archive file is imported, the content of the archive is always copied into the workspace and therefore this option is not available.
• Close newly imported projects upon completion
• Hide projects that already exist in the workspace
  Activate this option to exclude projects that are already existing in the workspace from the search result. The search result in the Projects area is automatically updated if this option is activated after the search has already been performed.
8. If you want to add the selected project(s) to a working set, activate the check box Add project to working sets and select an existing working set or create a new one via the buttons [Select...] or [New...], respectively.
9. Click [Finish] to import the selected DaVinci Adaptive project(s).

The selected DaVinci Adaptive project(s) is/are now available in the DaVinci Project Explorer. If the imported DaVinci Adaptive project(s) are used from its origin location, the workspace settings are updated automatically.

Convert a C/C++ Project

To convert an existing C/C++ project into a DaVinci Adaptive project, proceed as follows:

1. Convert to DaVinci Adaptive Project
2. In the Eclipse Project Explorer, open the context menu path Configure | Convert to DaVinci Adaptive Project... of the C/C++ project that you want to convert. The Convert to DaVinci Adaptive Project wizard opens.
2. Basic Settings
3. On the Basic Settings page, the name and location of your project are automatically applied.
4. In the Project Folders area, you can specify the following folder names:
• Model: This folder contains the AUTOSAR model files, i.e. the ARXML files. By default, this folder is named arxml. Enter the name of the Model folder or use the default name.
• Scripts: This folder contains the automation scripts that are specific for this project. By default, this folder is named scripts. Enter the name of the Scripts folder or use the default name.
5. Click [Next >] to proceed.
3. DaVinci Adaptive Project
4. On the DaVinci Adaptive Project page, you can configure DaVinci Adaptive projects that will be referenced by this project. The selection is optional and can also be done afterwards.
5. If required, activate the check box of the projects to be referenced.
6. Click [Next >] to confirm your settings.
4. Imports
5. On the Imports page, you can specify the files to be imported into you DaVinci Adaptive project. The selection is optional and can also be done afterwards.
6. If required, activate the check box Copy AUTOSAR Standard Types into project.
   If you want to copy external files (e.g. ARXML files) or folders into your project, click Add Files or Add Folder to add them.
7. Click [Finish] to convert the C/C++ project into a DaVinci Adaptive project.

The C/C++ project has been converted into a DaVinci Adaptive project. Refer to the section DaVinci Adaptive Support of the DaVinci Project Explorer for more information on the subfolders that are created when activating the DaVinci Adaptive Support for a project.

Nested Project Structures

Nested project structures are supported, but it is recommended to use them with caution due to potential complexities and the need for careful configuration.

1. Rule 1: Any directory containing a valid .project file is considered a project root directory. Each project root directory must have only one .project file.
2. Rule 2: If a ParentProject contains a nested ChildProject, never place ParentProject's project or ARXML files inside the ChildProject's root directory.

• Illustration of incorrect nested project structure
• The following structure is incorrect because the arxml folder of the ParentProject also serves as the root folder for the child project. This means that the ChildProject is not properly encapsulated within its own directory and instead shares the arxml folder with the ParentProject.
• This may cause integration issues, as the parent project won't be able to access and load any ARXML files located within the root folder for the child project. In this case file1.arxml and file2.arxml will not be loaded by the ParentProject.
• Workspace/
  └── ParentProject/
      ├── .adpa/
      ├── .settings/
      ├── arxml/
      │    ├──.adpa/
      │    ├── .settings/
      │    ├── arxmlChild/
      │    ├── scripts/
      │    ├── .project
      │    ├── file1.arxml
      │    └── file2.arxml
      ├── scripts/
      └── .project
• 1st illustration of correct nested project structure
• The illustration below shows an example of a correctly organized structure with two projects. The ARXML files for the ParentProject are contained outside the root directory of the ChildProject, ensuring proper separation of project files.
• Workspace/
  └── ParentProject/
      ├── .adpa/
      ├── .settings/
      ├── arxml/
      │    ├── ChildProject/
      │    │    ├── .adpa/
      │    │    ├── .settings/
      │    │    ├── arxml/
      │    │    ├── scripts/
      │    │    └── .project
      │    ├── file1.arxml
      │    └── file2.arxml
      ├── scripts/
      └── .project
• 2nd illustration of correct nested project structure
• Note that the ChildProject does not need to be located within the arxml directory, as in the previous illustration.
• Workspace/
  └── ParentProject/
      ├── .adpa/
      ├── .settings/
      ├── arxml/
      │    ├── file1.arxml
      │    └── file2.arxml
      ├── scripts/
      ├── .project
      └── ChildProject/