2026-03-08 11:45:38 -07:00
|
|
|
# Distributing Forji
|
|
|
|
|
|
2026-03-08 11:51:42 -07:00
|
|
|
A short description on how to distribute a new version of the Forji app to the Apple App Store.
|
|
|
|
|
|
|
|
|
|
## 0. Pre-Release
|
|
|
|
|
|
|
|
|
|
Make sure the code has no linting errors and is formatted correctly:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
just format
|
|
|
|
|
just lint
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Run all tests:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
just test
|
|
|
|
|
just test-ui
|
|
|
|
|
```
|
|
|
|
|
|
2026-03-08 11:45:38 -07:00
|
|
|
## 1. Bump the version
|
|
|
|
|
|
2026-03-08 12:02:12 -07:00
|
|
|
Check the current version:
|
2026-03-08 11:45:38 -07:00
|
|
|
|
2026-03-08 12:02:12 -07:00
|
|
|
```bash
|
|
|
|
|
just version
|
|
|
|
|
```
|
2026-03-08 11:45:38 -07:00
|
|
|
|
2026-03-08 12:02:12 -07:00
|
|
|
Set the new version:
|
2026-03-08 11:45:38 -07:00
|
|
|
|
|
|
|
|
```bash
|
2026-03-08 12:02:12 -07:00
|
|
|
just set-version 1.2
|
2026-03-08 11:45:38 -07:00
|
|
|
```
|
|
|
|
|
|
2026-03-08 12:02:12 -07:00
|
|
|
For simplicity we keep `MARKETING_VERSION` and `CURRENT_PROJECT_VERSION` the same.
|
2026-03-08 11:45:38 -07:00
|
|
|
|
|
|
|
|
## 2. Archive
|
|
|
|
|
|
|
|
|
|
1. Select the build destination **Any iOS Device (arm64)**
|
|
|
|
|
2. Select **Product → Archive**
|
|
|
|
|
3. Wait for the archive to complete
|
|
|
|
|
|
|
|
|
|
## 3. Upload
|
|
|
|
|
|
|
|
|
|
1. In the Organizer window (opens automatically after archiving), select the new archive
|
|
|
|
|
2. Click **Distribute App**
|
|
|
|
|
3. Follow the prompts to upload to App Store Connect
|
|
|
|
|
|
|
|
|
|
## 4. Release
|
|
|
|
|
|
|
|
|
|
1. Open [App Store Connect](https://appstoreconnect.apple.com)
|
|
|
|
|
2. Select the build, fill in release notes
|
|
|
|
|
3. Submit for review
|
