|
| 1 | +## Follow these steps to build the App on Physical IOS Device: |
| 2 | + |
| 3 | +1. **Plug in your device via USB** |
| 4 | + |
| 5 | + Connect your iOS device to your Mac using a USB cable. Navigate to the `ios` folder in project, then open the `.xcworkspace` file in Xcode. |
| 6 | +> [!Note] |
| 7 | +>If this is your first time running an app on your iOS device, you may need to register your device for development. Open the Product menu from Xcode's menubar, then go to Destination. Look for and select your device from the list. Xcode will then register your device for development. |
| 8 | +
|
| 9 | +2. **Configure code signing** |
| 10 | + |
| 11 | +> [!Important] |
| 12 | +> You must have a Apple Developer account to run your app on a physical device. If you don't have one, you can register here: [Apple Developer Program](https://developer.apple.com/). |
| 13 | +
|
| 14 | + 2.1. Go to `Signing and Capabilities` then in the section called `Signing (Debug/Development and Release/Development)` |
| 15 | + |
| 16 | +  |
| 17 | + |
| 18 | + 2.2. Enable `Automatically manage Signing` |
| 19 | + |
| 20 | + 2.3. Pick your personal team |
| 21 | + |
| 22 | + 2.4. Change the bundle identifier to something unique like `com.yourname.expensify.chat.dev` |
| 23 | + |
| 24 | +  |
| 25 | + |
| 26 | +> [!Note] |
| 27 | +>Please be aware that the app built with your own bundle id doesn't support authenticated services like push notification, apple signin, deeplinking etc. which should be only available in Expensify developer account. |
| 28 | + |
| 29 | + 2.5. Scroll down and Remove Associated Domains, Communication Notifications, Push Notifications, and Sign In With Apple capabilities |
| 30 | + |
| 31 | +  |
| 32 | + |
| 33 | + 2.6. Go to the `NotificationService` target and repeat Steps 2.2-2.4 |
| 34 | + |
| 35 | + 2.7. Go to the `Tests` target and repeat Steps 2.2-2.4 |
| 36 | + |
| 37 | +  |
| 38 | + |
| 39 | +3. **Build and Run your app** |
| 40 | + |
| 41 | + If everything is set up correctly, your device will be listed as the build target in the Xcode toolbar, and it will also appear in the Devices pane (Shift ⇧ + Cmd ⌘ + 2). You can now press the Build and run button (Cmd ⌘ + R) or select Run from the Product menu. Your app will launch on your device shortly. |
0 commit comments