asc-xcode-build

1# Xcode build and export
2 
3Use this skill when you need to build an app from source and prepare it for App Store Connect. Prefer `asc xcode archive` and `asc xcode export` over raw `xcodebuild` recipes when they fit the project.
4 
5## Preconditions
6 
7For a prepared xtool package on Linux, use [portable iOS builds](references/portable-ios.md)
8instead of the Xcode commands below. That workflow has a narrower project and signing contract.
9 
10- Xcode and command line tools are installed.
11- Signing identity and provisioning profiles are available, or automatic signing is enabled.
12- App Store Connect auth is configured when upload or build lookup is needed.
13 
14## Manage version and build numbers
15 
16```bash
17asc xcode version view
18asc xcode version edit --version "1.3.0" --build-number "42"
19asc xcode version edit --next-build-number --app "APP_ID" --platform IOS
20asc xcode version bump --type build
21asc xcode version bump --type patch
22asc xcode version bump --type build --next-build-number --app "APP_ID" --platform IOS
23```
24 
25Use `--project-dir "./MyApp"` when not running from the project root. Use `--project "./MyApp/App.xcodeproj"` when the directory contains multiple projects. Use `--target "App"` and `--configuration "Release"` for deterministic reads and writes in multi-target or multi-configuration projects.
26 
27To avoid low build-number rejects, resolve and apply the remote-safe build number in one command:
28 
29```bash
30…