Studio v0.2.0
Studio v0.2.0 · Product manual

Export an iOS project and Xcode archive

Export an iOS project and Xcode archive — GalCraft Studio product manual.

Choose iOS in Publishing and select the installed iOS 0.1.1 builder. Windows and Linux x64 export complete projects; macOS x64/arm64 also produce Xcode archives. Apply settings, save and check target assets using the overview.

1. Set identity and output

FieldValue
Bundle ID (bundleId)For example com.example.springlights, matching your Apple app identity; at least two segments, each starting with a letter and containing letters, digits or hyphens
Build number (buildNumber)One to three numeric segments, such as 1, 1.1 or 1.1.1; increment for subsequent distribution builds
OrientationLandscape or Both landscape orientations; default Landscape
OutputComplete Xcode project, or Xcode archive · requires macOS

The project targets iOS 15.0 or later. Archiving requires Xcode 16 or later. Select a dedicated output directory and choose Check and build.

2. Export on Windows and open on a Mac

  1. Choose Complete Xcode project, build and open the output.
  2. Keep all of ios-project/, including GalCraftPlayer.xcodeproj, the shared Scheme, Swift host, Info.plist and the Player, snapshot, template, media and font licences under GalCraftPlayer/Game/.
  3. Copy the complete directory to a Mac and open GalCraftPlayer.xcodeproj in Xcode.
  4. In Signing & Capabilities, select your team and review the Bundle Identifier, signing certificate and provisioning profile. Choose a target device and run.
  5. Create an archive for distribution. Use Distribute App in Xcode Organizer to choose TestFlight, App Store Connect or an applicable device distribution method. Follow Apple’s distribution guide.

The project also includes build.sh for invoking the Xcode toolchain on macOS according to its instructions.

3. Archive from Studio on macOS

  1. Install Xcode and the required iOS tools, complete first-launch setup and select that Xcode for command-line use.
  2. Choose Xcode archive · requires macOS. Enter Apple development team ID, the 10-character uppercase alphanumeric Team ID from your developer account.
  3. Prepare that team’s signing identity and provisioning profile in local Xcode. The Studio form uses automatic signing. The public builder port also accepts optional signingProfileId for a manual signing profile; omitting it uses automatic signing.
  4. Select the output and choose Check and build. The builder invokes xcodebuild with the GalCraftPlayer Scheme, Release configuration and generic/platform=iOS destination.
  5. Locate artifacts/GalCraftPlayer.xcarchive in the receipt. The output also retains ios-project/.
  6. Open the archive in Xcode Organizer and choose Distribute App to continue signing configuration, validation, export or upload through Apple’s official flow.

If the system requires macOS, choose Complete Xcode project and follow the handoff above. When archiving fails, correct the reported Xcode, team or signing issue, then recheck and rebuild with the retained input.

Other targets: Web · Windows · Android.