Frontend Build and Deployment - bluecolab/BlueColab_MobileDataViz GitHub Wiki
Frontend Build and Deployment
Building and Deploying App - Android
Building (preparation for deployment) is handled by GitHub Actions. Deployment (releasing the app) is a manual process.
Requirements
- Google Developer Account
- Additional Requirements (beyond the usual like name, email):
- Privacy Policy (https://bluecolab.github.io/BlueColab_MobileDataViz/, edit the policy here)
- Website (okurakeng.github.io)
- Feedback Form (https://docs.google.com/forms/d/1EiEnmUMdi-9sctza0u7vyeFb72yeLmUnjuCL5ABabn0/edit)
- Additional Requirements (beyond the usual like name, email):
- Expo Developer Account
- Keys
- Expo Personal Access Token with the name
EXPO_TOKEN
. To add tokens to the repo see here. - To create your Personal Access Token see here: https://expo.dev/settings/access-tokens.
- Expo Personal Access Token with the name
YAML File
See: https://github.com/bluecolab/BlueColab_MobileDataViz/blob/main/.github/workflows/frontend_build.yml
Building an Android Store Build
Automatic Builds
- Test locally
- Open a PR that has frontend changes. Must be in
aquawatch_mobile_app
directory. - Merge the PR into
main
. - Pull the
main
branch into the branch calledapp-build-branch
. (Rungit pull origin main
). - Fix any merge conflicts.
- Push the local
app-build-branch
to GitHub. - A GitHub workflow should be triggered.
- Login into Expo account.
- Navigate to most recent build (it will be there, but may still be building).
- Download the app bundle build once complete. Should be
.aab
file.
Manual Builds
One time steps:
- In a command line enter:
npm install -g eas-cli
- In a command line enter:
eas login
and login. Log in with Blue CoLab credentials.
Build Step:
- Open terminal in directory of app.
- Switch to
app-build-branch
branch. - In a command line enter:
eas build --platform android
. - Follow step 6 and onwards from above.
[!IMPORTANT] In general build times should take about 10 minutes. The queue time varies, late nights queues are much shorter.
Building an Android Dev Build
- Open terminal in directory of app.
- Switch to
app-build-branch
branch. - In a command line enter:
eas build --platform android --profile preview
. - Follow step 6 and onwards from above.
Publishing Android Store Build
tbd
Publishing Dev Build to GitHub
tbd