|
8 | 8 |
|
9 | 9 | ## Getting Started
|
10 | 10 |
|
11 |
| -- clone Repo |
12 | 11 | - `cd example/RNExampleApp`
|
13 |
| -- `npm/yarn install` |
14 |
| -- `npm/yarn run reinstall` |
15 |
| -- `cd ios` |
16 |
| -- `pod update` |
| 12 | +- `npm install` or `yarn install` |
| 13 | +- `npm run reinstall` or `yarn reinstall` |
| 14 | +- `npm run <PLATFORM>` or `yarn <PLATFORM>`, where PLATFORM is one of 'ios' or 'android' |
17 | 15 |
|
18 | 16 | ### Set the License Key
|
19 | 17 |
|
@@ -53,16 +51,37 @@ npx react-native bundle --platform android --dev false --entry-file index.js --b
|
53 | 51 |
|
54 | 52 | #### Troubleshooting
|
55 | 53 |
|
56 |
| -* Make sure you have the latest/correct version of node installed |
| 54 | +* Make sure you have the latest/correct version of node installed. |
57 | 55 | * If you get stuck completely on Android, go into the "android" directory and do a gradle clean: `cd example/RNExampleApp/android/`, then `./gradlew clean`.
|
58 |
| -* Examples app won't build or run correctly on iOS? Execute these commands from `example/RNExampleApp`: |
59 |
| - * `rm -rf node_modules package-lock.json ios/Pods ios/Podfile.lock ios/RNExampleApp.xcworkspace` |
60 |
| - * `yarn cache clean` |
61 |
| - * `yarn reinstall` |
62 |
| - * `yarn ios` (this does `expo run:ios --device`) |
63 |
| - |
64 |
| -TIP: when debugging issues, try and build and run the examples app with the xcworkspace on Xcode. If there are issues, they will have more actionable steps. |
65 | 56 |
|
66 | 57 | ### iOS
|
67 | 58 |
|
68 |
| -Open `example/RNExampleApp/iOS/RNExampleApp.xcworkspace` with XCode and build/deploy to device. |
| 59 | +Run `yarn ios` from `example/RNExampleApp` to build and deploy the developer examples app to a device. |
| 60 | + |
| 61 | +Alternatively, you can open `example/RNExampleApp/iOS/RNExampleApp.xcworkspace` with Xcode. |
| 62 | + |
| 63 | +TIP: when debugging certain issues, when possible, try to build and run the examples app from Xcode by opening the `ios/*.xcworkspace file`. Xcode can usually present the issues more clearly and provide better actionable steps. |
| 64 | + |
| 65 | + |
| 66 | +#### Troubleshooting |
| 67 | + |
| 68 | +To do a fresh build and install of the developer examples app on iOS, execute the following commands from `example/RNExampleApp`: |
| 69 | + |
| 70 | +``` |
| 71 | +rm -rf node_modules package-lock.json |
| 72 | +rm -rf ios/Pods ios/Podfile.lock ios/RNExampleApp.xcworkspace |
| 73 | +npm cache clean --force |
| 74 | +npm install |
| 75 | +npm run reinstall |
| 76 | +``` |
| 77 | + |
| 78 | +Doing this may help resolve up some issues with NPM dependencies. |
| 79 | + |
| 80 | + |
| 81 | +NOTE: If you're running on iOS, recent versions of the developer examples app may require [patch-package](https://github.com/ds300/patch-package) to be installed beforehand: |
| 82 | + |
| 83 | +``` |
| 84 | +npm install --save-dev patch-package postinstall-postinstall |
| 85 | +``` |
| 86 | + |
| 87 | +For additional information, read on for more details: [Verification checksum was incorrect](https://github.com/boostorg/boost/issues/843) |
0 commit comments