You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/setup.md
+10-11Lines changed: 10 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -41,11 +41,14 @@
41
41
-`REACT_APP_GOOGLE_ANALYTICS_TRACKING_ID`: Tracking ID for Google Analytics. Optional.
42
42
43
43
- Additional (top secret) environment variables in `.env` are needed to sign and release the mobile apps.
44
+
44
45
-`ANDROID_KEYSTORE_PATH`
45
46
-`ANDROID_KEYSTORE_PASSWORD`
46
47
-`ANDROID_KEYSTORE_ALIAS`
47
48
-`ANDROID_KEYSTORE_ALIAS_PASSWORD`
48
49
50
+
- Additional `.env.android` and `.env.ios` files are used to set platform-specific environment variables that override those in `.env` when building for that platform.
51
+
49
52
# Web app
50
53
51
54
- Start the application.
@@ -74,7 +77,7 @@ yarn
74
77
75
78
# Mobile apps
76
79
77
-
We use [Capacitor](https://capacitorjs.com) to package the web app as Android and iOS apps. Make sure you can build the web app first with `yarn build` before proceeding. Although most of the mobile app can be tested by opening the web app in a narrow browser window, this is inadequate for testing device-specific functionality like permissions, curved layouts, and onboard functions (camera, compass, and GPS).
80
+
We use [Capacitor](https://capacitorjs.com) to package the web app as Android and iOS apps. Although most of the mobile app can be tested by opening the web app in a narrow browser window, this is inadequate for testing device-specific functionality like permissions, curved layouts, and onboard functions (camera, compass, and GPS).
78
81
79
82
## Bump app versions
80
83
@@ -101,21 +104,16 @@ First install the [requirements](https://capacitorjs.com/docs/v7/getting-started
101
104
Sync the app with any changes to [`package.json`](../package.json) and `build` output:
102
105
103
106
```sh
107
+
yarn build:android
104
108
npx cap sync android
105
109
```
106
110
107
-
Run the app on an emulator or device:
111
+
Run the app on an emulator or device (see below) and debug with Chrome at [chrome://inspect/#devices](chrome://inspect/#devices).
108
112
109
113
```bash
110
-
npx cap run android # prompts to select device
111
-
# npx cap run android --list
112
-
# npx cap run android --device
113
-
# npx cap run android --emulator
114
-
# npx cap run android --target=<device>
114
+
npx cap run android
115
115
```
116
116
117
-
and debug with Chrome at [chrome://inspect/#devices](chrome://inspect/#devices).
118
-
119
117
Alternatively, open as a project in Android Studio:
120
118
121
119
```sh
@@ -133,7 +131,7 @@ Then plug the device into your computer, start the `adb` (Android Debug Bridge)
133
131
134
132
```sh
135
133
sudo adb start-server
136
-
npx cap run android
134
+
adb devices
137
135
```
138
136
139
137
### Release
@@ -159,7 +157,7 @@ First install the [requirements](https://capacitorjs.com/docs/v7/getting-started
0 commit comments