Walkthrough recorded in 0.5.0-alpha5

Import an existing sector file

Create a project from an Aurora .isc file and its supporting files.

Download this guide for offline use

This walkthrough follows the EKDK example. Use your own root sector file and supporting folders when you repeat the steps.

1. Open the Import Wizard

In Aurora Sector Studio, choose File → Import Sectorfiles….

The File menu with Import Sectorfiles highlighted
The File menu with Import Sectorfiles highlighted · Open image for full size

2. Select the root .isc file

On Select Root .isc, click Browse…, select the main sector file, and click Open. The walkthrough uses C:\Aurora\SectorFiles\EKDK.isc. Keep its supporting files and folder structure available while importing.

Confirm the selected path, then click Next.

Select Root .isc with EKDK.isc selected
Select Root .isc with EKDK.isc selected · Open image for full size

3. Analyze the references

On Analyze References, wait for Scan complete. Review the root file and the discovered includes and references. Scroll through the list to check for missing files. If you correct the source files, use Rescan to update the list.

Click Next when you are ready to continue.

Analyze References showing the sector file and explicit includes
Analyze References showing the sector file and explicit includes · Open image for full size

4. Choose where to create the project

On Choose Destination:

  1. Use Browse… to select a Destination parent folder outside the source folder.
  2. Set the Project folder name; the walkthrough uses EKDK.
  3. Set the Project display name; the walkthrough also uses EKDK.
  4. Click Next.

The project folder is created inside the parent folder you choose. Use a new or empty project folder; the wizard cannot replace an existing project.

Choose Destination showing the parent folder and project names
Choose Destination showing the parent folder and project names · Open image for full size

5. Choose the import options

The walkthrough enables all three options:

Option What it includes
Include implicit references Additional supporting files discovered through the sector's implicit reference rules.
Import outside-root files as external/ Referenced files outside the root sector file's folder, copied into the project's external/ area.
Copy entire include folder The contents of the source include folder, including files beyond the discovered references.

To follow the walkthrough, leave the first two options checked and check Copy entire include folder, then click Next.

Import Options with all three checkboxes enabled
Import Options with all three checkboxes enabled · Open image for full size

6. Review and import

On Review & Import, confirm the root .isc, destination, project folder and display name. Scroll through the reference preview and check any missing-file entries before proceeding.

Click Import and wait for Aurora Sector Studio to finish creating and opening the project.

Review & Import with the summary and Import button
Review & Import with the summary and Import button · Open image for full size

7. Check the opened project

The imported root .isc opens in the editor, and the Explorer shows the project's sector data. Use the Files tab to browse its files and folders.

Check the Problems panel before continuing. The recorded EKDK import opens with errors and warnings listed; an opened project does not mean its sector data has passed validation. Review the reported entries as part of preparing the project.

The imported EKDK project open with its Explorer and Problems panel
The imported EKDK project open with its Explorer and Problems panel · Open image for full size

You can reopen the imported project later using File → Open Project Folder… and selecting the project folder you created.