diff --git a/assets/setup-xcode-signing/01-add-signing-account.png b/assets/setup-xcode-signing/01-add-signing-account.png new file mode 100644 index 0000000..b1bf173 Binary files /dev/null and b/assets/setup-xcode-signing/01-add-signing-account.png differ diff --git a/assets/setup-xcode-signing/02-build-app-for-device.png b/assets/setup-xcode-signing/02-build-app-for-device.png new file mode 100644 index 0000000..6447565 Binary files /dev/null and b/assets/setup-xcode-signing/02-build-app-for-device.png differ diff --git a/setup-xcode-signing.md b/setup-xcode-signing.md index 85b8774..1399d00 100644 --- a/setup-xcode-signing.md +++ b/setup-xcode-signing.md @@ -4,20 +4,25 @@ In order to build an iOS app with custom entitlements, you'll need to setup _cod > 💡 Certificates are saved to your local Keychain so you don't need to set them up often. -![code-signing-page](https://user-images.githubusercontent.com/9664363/112059266-db521e00-8b18-11eb-9538-2a31c6bd6e39.png) - - 1. Open your iOS project in Xcode by running `xed ios` or `open ios/.xcworkspace` in your Terminal. If your Expo project doesn't have an `ios` folder, run `npx expo prebuild -p ios` to generate one locally. 2. Select the first project in the **navigator** then the target with the matching native in the "project and targets list". 3. Select "Signing & Capabilities", ensure you have "Automatically manage signing" selected. 4. Ensure a "Development Team" is selected, this may require that you sign-in to your Apple Developer account. 1. Press the "Add Account" button next to the team label. Follow the sign in flow. -5. Select a physical device to build the app onto, Xcode will add this device to your account. -6. Build the app onto your device. - 1. You may need to "trust" the device you just added to the Xcode "Development Certificate", this is done in your iOS device. - 2. Navigate: Settings > General > Device Management > [your new certificate] > Trust. + + ![](./assets/setup-xcode-signing/01-add-signing-account.png) + +5. Select a physical device from the dropdown at the top-center of the UI. Xcode will add this device to your account. +6. Build the app onto your device by pressing the "Play" symbol at the top-left of the the UI. + + ![](./assets/setup-xcode-signing/02-build-app-for-device.png) + + 1. You may need to "trust" the device you just added to the Xcode "Development Certificate", this is done in your iOS device in: Settings > General > Device Management > [your new certificate] > Trust. Learn more: [Apple docs (MaintainingCertificates)](https://developer.apple.com/library/content/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingCertificates/MaintainingCertificates.html). + 2. You may need to enable Developer Mode for your device. This is done in your iOS device in: Settings > Privacy > Developer Mode. + If the Developer Mode option doesn't appear, you might need to unplug your iOS device from your computer. + Learn more: [Apple docs (Enabling Developer Mode)](hhttps://developer.apple.com/documentation/xcode/enabling-developer-mode-on-a-device). -Now you can return to Expo CLI and build your project locally with `npx expo run:ios`. This process only needs to be done once per computer / account, you don't need to do this for every new native project. +7. Now you can return to Expo CLI and build your project locally with `npx expo run:ios`. The process above only needs to be done once per computer / account, you don't need to do this for every new native project. > Simulators require code signing when certain entitlements are enabled, e.g. Associated Domains.