mirror of
https://gitlab.com/openstapps/openstapps.git
synced 2026-01-21 09:03:02 +00:00
refactor: move app-release-template to monorepo
This commit is contained in:
33
frontend/app-release-template/README.md
Normal file
33
frontend/app-release-template/README.md
Normal file
@@ -0,0 +1,33 @@
|
||||
# App Release Template (ART)
|
||||
|
||||
This project can be used to generate mobile device apps (Android / iOS) and the standalone Angular web app. Beware that this is only the app/frontend part and your need a fully functioning backend deployment first.
|
||||
|
||||
## Requirements
|
||||
|
||||
* A fully functioning and publicly accessible [backend](https://gitlab.com/openstapps/backend) deployment
|
||||
* An active Apple App Store Developer Account and/or Google Playstore Developer Account
|
||||
* Docker (Android and Angular builds)
|
||||
* MacOS Device with latest Xcode, fastlane and xmlstarlet, node v14 and npm package @ionic/cli (iOS builds only)
|
||||
|
||||
## Docker
|
||||
|
||||
Use weelkly updated image from this repo
|
||||
|
||||
```bash
|
||||
docker pull registry.gitlab.com/openstapps/app-release-template:latest
|
||||
```
|
||||
|
||||
Or build your own image from Dockerfile within this project
|
||||
|
||||
```bash
|
||||
docker build -t openstapps-art .
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
0. If neccessary make adjustments to your app / profiles / entitlements in your corresponding developer/store portal
|
||||
1. Overwrite assets in customizable directory with your own ones (keeping the same size and file format)
|
||||
2. Edit app.conf.sample to your liking and rename it to app.conf (needs info you can find in your corresponding developer/store portal)
|
||||
3. Use docker to run `make web` and `make android` (i.e. `docker run -it -v $(pwd):/build --rm openstapps-art:latest make web`)
|
||||
4. On a macOS device run `make ios` (make sure you have all required certificates / profiles set up in Xcode)
|
||||
5. Gitlab CI runs need to be provided with SCP targets and Base64 encoded SSH private keys via env variables for web and (optionally) apk deployments
|
||||
Reference in New Issue
Block a user