Compare commits
7
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
0e131e1db2 | ||
|
|
137815ad25 | ||
|
|
c299d46f91 | ||
|
|
b2bfb6d84d | ||
|
|
7b04b2f9cd | ||
|
|
7f060f381a | ||
|
|
4779406d62 |
@@ -0,0 +1,223 @@
|
|||||||
|
# kryz-go-flutter CI Pipeline
|
||||||
|
# Triggers on push and pull_request
|
||||||
|
# Stages: lint -> test -> build (Android + iOS) -> artifacts
|
||||||
|
|
||||||
|
name: CI
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main, develop]
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
|
||||||
|
# Cancel in-progress runs on new push to same branch
|
||||||
|
concurrency:
|
||||||
|
group: ${{ gitea.workflow }}-${{ gitea.ref }}
|
||||||
|
cancel-in-progress: true
|
||||||
|
|
||||||
|
env:
|
||||||
|
FLUTTER_VERSION: "3.41.x"
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
# ── Stage 1: Lint & static analysis ──────────────────────────────
|
||||||
|
lint:
|
||||||
|
name: Lint
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Flutter
|
||||||
|
uses: subosito/flutter-action@v2
|
||||||
|
with:
|
||||||
|
flutter-version: ${{ env.FLUTTER_VERSION }}
|
||||||
|
cache: true
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: flutter pub get
|
||||||
|
|
||||||
|
- name: Generate stubs (lint gate support)
|
||||||
|
if: hashFiles('theme.json') == ''
|
||||||
|
run: python3 ci_stub_gen.py
|
||||||
|
|
||||||
|
- name: Analyze Dart code
|
||||||
|
run: flutter analyze --fatal-warnings
|
||||||
|
|
||||||
|
- name: Check formatting
|
||||||
|
run: dart format --set-exit-if-changed lib/ test/
|
||||||
|
|
||||||
|
|
||||||
|
# ── Stage 2: Unit & widget tests ─────────────────────────────────
|
||||||
|
test:
|
||||||
|
name: Test
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
needs: [lint]
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Flutter
|
||||||
|
uses: subosito/flutter-action@v2
|
||||||
|
with:
|
||||||
|
flutter-version: ${{ env.FLUTTER_VERSION }}
|
||||||
|
cache: true
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: flutter pub get
|
||||||
|
|
||||||
|
- name: Generate stubs (lint gate support)
|
||||||
|
run: python3 ci_stub_gen.py
|
||||||
|
|
||||||
|
- name: Run tests
|
||||||
|
run: flutter test --reporter=expanded
|
||||||
|
|
||||||
|
- name: Run tests with coverage
|
||||||
|
if: gitea.ref == 'refs/heads/main' && gitea.event_name == 'push'
|
||||||
|
run: flutter test --coverage
|
||||||
|
|
||||||
|
- name: Upload coverage report
|
||||||
|
if: gitea.ref == 'refs/heads/main' && gitea.event_name == 'push'
|
||||||
|
uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: coverage-report
|
||||||
|
path: coverage/lcov.info
|
||||||
|
retention-days: 14
|
||||||
|
|
||||||
|
|
||||||
|
# ── Stage 3: Android build ──────────────────────────────────────
|
||||||
|
build-android:
|
||||||
|
name: Build Android
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
needs: [test]
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Java 17
|
||||||
|
uses: actions/setup-java@v4
|
||||||
|
with:
|
||||||
|
distribution: temurin
|
||||||
|
java-version: "17"
|
||||||
|
cache: gradle
|
||||||
|
|
||||||
|
- name: Setup Flutter
|
||||||
|
uses: subosito/flutter-action@v2
|
||||||
|
with:
|
||||||
|
flutter-version: ${{ env.FLUTTER_VERSION }}
|
||||||
|
cache: true
|
||||||
|
|
||||||
|
- name: Pre-cache Android platform artifacts
|
||||||
|
run: flutter precache --android
|
||||||
|
|
||||||
|
- name: Accept Android SDK licenses
|
||||||
|
run: |
|
||||||
|
yes | sdkmanager --licenses || true
|
||||||
|
|
||||||
|
- name: Setup Python (for whitelabel build script)
|
||||||
|
uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.12"
|
||||||
|
|
||||||
|
- name: Install Python dependencies
|
||||||
|
run: |
|
||||||
|
python -m pip install --upgrade pip
|
||||||
|
pip install -r requirements.txt
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: flutter pub get
|
||||||
|
|
||||||
|
- name: Generate stubs (lint gate support)
|
||||||
|
run: python3 ci_stub_gen.py
|
||||||
|
|
||||||
|
- name: Analyze (gate before build)
|
||||||
|
run: flutter analyze --fatal-warnings
|
||||||
|
|
||||||
|
- name: Run tests (gate before build)
|
||||||
|
run: flutter test --reporter=expanded
|
||||||
|
|
||||||
|
# Optional: run whitelabel build script to regenerate lib/generated/
|
||||||
|
# Skip gracefully if theme.json is missing or script fails
|
||||||
|
- name: Run whitelabel build script
|
||||||
|
if: hashFiles('theme.json') != ''
|
||||||
|
run: python3 build_whitelabel.py
|
||||||
|
|
||||||
|
- name: Configure release signing
|
||||||
|
if: env.ANDROID_KEYSTORE_BASE64 != ''
|
||||||
|
env:
|
||||||
|
ANDROID_KEYSTORE_BASE64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }}
|
||||||
|
ANDROID_KEYSTORE_PASS: ${{ secrets.ANDROID_KEYSTORE_PASS }}
|
||||||
|
ANDROID_KEY_ALIAS: ${{ secrets.ANDROID_KEY_ALIAS }}
|
||||||
|
ANDROID_KEY_PASS: ${{ secrets.ANDROID_KEY_PASS }}
|
||||||
|
run: |
|
||||||
|
# Decode keystore
|
||||||
|
echo "$ANDROID_KEYSTORE_BASE64" | base64 -d > android/app/release.keystore
|
||||||
|
|
||||||
|
# Write key.properties for Gradle to consume
|
||||||
|
cat > android/key.properties <<EOF
|
||||||
|
storePassword=$ANDROID_KEYSTORE_PASS
|
||||||
|
keyPassword=$ANDROID_KEY_PASS
|
||||||
|
keyAlias=$ANDROID_KEY_ALIAS
|
||||||
|
storeFile=../release.keystore
|
||||||
|
EOF
|
||||||
|
|
||||||
|
- name: Build APK (release)
|
||||||
|
run: flutter build apk --release
|
||||||
|
|
||||||
|
- name: Build App Bundle (release)
|
||||||
|
run: flutter build appbundle --release
|
||||||
|
|
||||||
|
- name: List build outputs
|
||||||
|
run: |
|
||||||
|
echo "=== APK output ==="
|
||||||
|
ls -lh build/app/outputs/flutter-apk/ || true
|
||||||
|
echo "=== AAB output ==="
|
||||||
|
ls -lh build/app/outputs/bundle/release/ || true
|
||||||
|
|
||||||
|
- name: Upload APK artifact
|
||||||
|
uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: android-apk
|
||||||
|
path: build/app/outputs/flutter-apk/app-release.apk
|
||||||
|
retention-days: 90
|
||||||
|
|
||||||
|
- name: Upload AAB artifact
|
||||||
|
uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: android-aab
|
||||||
|
path: build/app/outputs/bundle/release/app-release.aab
|
||||||
|
retention-days: 90
|
||||||
|
|
||||||
|
|
||||||
|
# ── Stage 3 (parallel): iOS build ───────────────────────────────
|
||||||
|
# Note: requires a macOS runner. Uses 'self-hosted' label which
|
||||||
|
# matches our Gitea Actions runner. Falls back to --no-codesign
|
||||||
|
# if Apple signing secrets are not configured.
|
||||||
|
build-ios:
|
||||||
|
name: Build iOS
|
||||||
|
runs-on: self-hosted
|
||||||
|
needs: [test]
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Flutter
|
||||||
|
uses: subosito/flutter-action@v2
|
||||||
|
with:
|
||||||
|
flutter-version: ${{ env.FLUTTER_VERSION }}
|
||||||
|
cache: true
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: flutter pub get
|
||||||
|
|
||||||
|
- name: Install CocoaPods dependencies
|
||||||
|
run: cd ios && pod install --repo-update
|
||||||
|
|
||||||
|
- name: Build iOS (release, no-codesign)
|
||||||
|
run: flutter build ios --release --no-codesign
|
||||||
|
|
||||||
|
- name: Upload iOS build artifact
|
||||||
|
uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: ios-app
|
||||||
|
path: build/ios/iphoneos/
|
||||||
|
retention-days: 90
|
||||||
@@ -0,0 +1,277 @@
|
|||||||
|
# kryz-go-flutter Release Pipeline
|
||||||
|
# Triggers on version tags (v1.0.0, v1.0.1, etc.)
|
||||||
|
# Produces signed artifacts and attaches them to a Gitea Release
|
||||||
|
|
||||||
|
name: Release
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
tags:
|
||||||
|
- "v*"
|
||||||
|
|
||||||
|
env:
|
||||||
|
FLUTTER_VERSION: "3.41.x"
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
# ── Lint (gate) ─────────────────────────────────────────────
|
||||||
|
lint:
|
||||||
|
name: Lint
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Flutter
|
||||||
|
uses: subosito/flutter-action@v2
|
||||||
|
with:
|
||||||
|
flutter-version: ${{ env.FLUTTER_VERSION }}
|
||||||
|
cache: true
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: flutter pub get
|
||||||
|
|
||||||
|
- name: Generate stubs (lint gate support)
|
||||||
|
if: hashFiles('theme.json') == ''
|
||||||
|
run: python3 ci_stub_gen.py
|
||||||
|
|
||||||
|
- name: Analyze Dart code
|
||||||
|
run: flutter analyze --fatal-warnings
|
||||||
|
|
||||||
|
- name: Check formatting
|
||||||
|
run: dart format --set-exit-if-changed lib/ test/
|
||||||
|
|
||||||
|
|
||||||
|
# ── Test (gate) ──────────────────────────────────────────────────
|
||||||
|
test:
|
||||||
|
name: Test
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
needs: [lint]
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Flutter
|
||||||
|
uses: subosito/flutter-action@v2
|
||||||
|
with:
|
||||||
|
flutter-version: ${{ env.FLUTTER_VERSION }}
|
||||||
|
cache: true
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: flutter pub get
|
||||||
|
|
||||||
|
- name: Generate stubs (lint gate support)
|
||||||
|
run: python3 ci_stub_gen.py
|
||||||
|
|
||||||
|
- name: Run tests
|
||||||
|
run: flutter test --reporter=expanded
|
||||||
|
|
||||||
|
|
||||||
|
# ── Android release build ───────────────────────────────────
|
||||||
|
build-android:
|
||||||
|
name: Build Android Release
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
needs: [test]
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Java 17
|
||||||
|
uses: actions/setup-java@v4
|
||||||
|
with:
|
||||||
|
distribution: temurin
|
||||||
|
java-version: "17"
|
||||||
|
cache: gradle
|
||||||
|
|
||||||
|
- name: Setup Flutter
|
||||||
|
uses: subosito/flutter-action@v2
|
||||||
|
with:
|
||||||
|
flutter-version: ${{ env.FLUTTER_VERSION }}
|
||||||
|
cache: true
|
||||||
|
|
||||||
|
- name: Pre-cache Android platform artifacts
|
||||||
|
run: flutter precache --android
|
||||||
|
|
||||||
|
- name: Accept Android SDK licenses
|
||||||
|
run: |
|
||||||
|
yes | sdkmanager --licenses || true
|
||||||
|
|
||||||
|
- name: Setup Python
|
||||||
|
uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.12"
|
||||||
|
|
||||||
|
- name: Install Python dependencies
|
||||||
|
run: |
|
||||||
|
python -m pip install --upgrade pip
|
||||||
|
pip install -r requirements.txt
|
||||||
|
|
||||||
|
- name: Install Flutter dependencies
|
||||||
|
run: flutter pub get
|
||||||
|
|
||||||
|
- name: Generate stubs (lint gate support)
|
||||||
|
run: python3 ci_stub_gen.py
|
||||||
|
|
||||||
|
# If release signing secrets are available, write keystore
|
||||||
|
# and update build.gradle.kts to use a release signing config.
|
||||||
|
# Otherwise fall back to debug keys (current state of the repo).
|
||||||
|
- name: Configure release signing
|
||||||
|
if: env.ANDROID_KEYSTORE_BASE64 != ''
|
||||||
|
env:
|
||||||
|
ANDROID_KEYSTORE_BASE64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }}
|
||||||
|
ANDROID_KEYSTORE_PASS: ${{ secrets.ANDROID_KEYSTORE_PASS }}
|
||||||
|
ANDROID_KEY_ALIAS: ${{ secrets.ANDROID_KEY_ALIAS }}
|
||||||
|
ANDROID_KEY_PASS: ${{ secrets.ANDROID_KEY_PASS }}
|
||||||
|
run: |
|
||||||
|
echo "$ANDROID_KEYSTORE_BASE64" | base64 -d > android/app/release.keystore
|
||||||
|
cat > android/key.properties <<EOF
|
||||||
|
storePassword=$ANDROID_KEYSTORE_PASS
|
||||||
|
keyPassword=$ANDROID_KEY_PASS
|
||||||
|
keyAlias=$ANDROID_KEY_ALIAS
|
||||||
|
storeFile=../release.keystore
|
||||||
|
EOF
|
||||||
|
|
||||||
|
- name: Build APK (release)
|
||||||
|
run: flutter build apk --release
|
||||||
|
|
||||||
|
- name: Build App Bundle (release)
|
||||||
|
run: flutter build appbundle --release
|
||||||
|
|
||||||
|
- name: List build outputs
|
||||||
|
run: |
|
||||||
|
echo "=== APK output ==="
|
||||||
|
ls -lh build/app/outputs/flutter-apk/ || true
|
||||||
|
echo "=== AAB output ==="
|
||||||
|
ls -lh build/app/outputs/bundle/release/ || true
|
||||||
|
|
||||||
|
- name: Upload APK artifact
|
||||||
|
uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: release-android-apk
|
||||||
|
path: build/app/outputs/flutter-apk/app-release.apk
|
||||||
|
retention-days: 90
|
||||||
|
|
||||||
|
- name: Upload AAB artifact
|
||||||
|
uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: release-android-aab
|
||||||
|
path: build/app/outputs/bundle/release/app-release.aab
|
||||||
|
retention-days: 90
|
||||||
|
|
||||||
|
|
||||||
|
# ── iOS release build ───────────────────────────────────────
|
||||||
|
# Note: requires a macOS runner. Uses 'self-hosted' label which
|
||||||
|
# matches our Gitea Actions runner. Falls back to --no-codesign
|
||||||
|
# if Apple signing secrets are not configured.
|
||||||
|
build-ios:
|
||||||
|
name: Build iOS Release
|
||||||
|
runs-on: self-hosted
|
||||||
|
needs: [test]
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Flutter
|
||||||
|
uses: subosito/flutter-action@v2
|
||||||
|
with:
|
||||||
|
flutter-version: ${{ env.FLUTTER_VERSION }}
|
||||||
|
cache: true
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: flutter pub get
|
||||||
|
|
||||||
|
- name: Install CocoaPods dependencies
|
||||||
|
run: cd ios && pod install --repo-update
|
||||||
|
|
||||||
|
# Configure Apple signing if secrets are available
|
||||||
|
- name: Install Apple certificate
|
||||||
|
if: env.APPLE_CERTIFICATE_P12 != ''
|
||||||
|
env:
|
||||||
|
APPLE_CERTIFICATE_P12: ${{ secrets.APPLE_CERTIFICATE_P12 }}
|
||||||
|
APPLE_CERTIFICATE_PASS: ${{ secrets.APPLE_CERTIFICATE_PASS }}
|
||||||
|
APPLE_PROVISION_PROFILE: ${{ secrets.APPLE_PROVISION_PROFILE }}
|
||||||
|
run: |
|
||||||
|
KEYCHAIN_PATH=$RUNNER_TEMP/build.keychain
|
||||||
|
CERTIFICATE_PATH=$RUNNER_TEMP/certificate.p12
|
||||||
|
PROVISION_PATH=$RUNNER_TEMP/profile.mobileprovision
|
||||||
|
|
||||||
|
echo "$APPLE_CERTIFICATE_P12" | base64 -d > "$CERTIFICATE_PATH"
|
||||||
|
echo "$APPLE_PROVISION_PROFILE" | base64 -d > "$PROVISION_PATH"
|
||||||
|
|
||||||
|
security create-keychain -p "" "$KEYCHAIN_PATH"
|
||||||
|
security default-keychain -s "$KEYCHAIN_PATH"
|
||||||
|
security unlock-keychain -p "" "$KEYCHAIN_PATH"
|
||||||
|
security set-keychain-settings -t 3600 -l "$KEYCHAIN_PATH"
|
||||||
|
security import "$CERTIFICATE_PATH" -P "$APPLE_CERTIFICATE_PASS" \
|
||||||
|
-A -t cert -f pkcs12 -k "$KEYCHAIN_PATH"
|
||||||
|
security set-key-partition-list -S apple-tool:,apple: -k "" "$KEYCHAIN_PATH"
|
||||||
|
|
||||||
|
mkdir -p ~/Library/MobileDevice/Provisioning\ Profiles
|
||||||
|
cp "$PROVISION_PATH" ~/Library/MobileDevice/Provisioning\ Profiles/
|
||||||
|
|
||||||
|
- name: Build iOS (release)
|
||||||
|
if: env.APPLE_CERTIFICATE_P12 != ''
|
||||||
|
run: flutter build ios --release
|
||||||
|
|
||||||
|
- name: Build iOS (release, no-codesign)
|
||||||
|
if: env.APPLE_CERTIFICATE_P12 == ''
|
||||||
|
run: flutter build ios --release --no-codesign
|
||||||
|
|
||||||
|
- name: Upload iOS artifact
|
||||||
|
uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: release-ios-app
|
||||||
|
path: build/ios/iphoneos/
|
||||||
|
retention-days: 90
|
||||||
|
|
||||||
|
|
||||||
|
# ── Publish Gitea Release ────────────────────────────────────
|
||||||
|
publish-release:
|
||||||
|
name: Publish Release
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
needs: [build-android, build-ios]
|
||||||
|
steps:
|
||||||
|
- name: Download Android APK
|
||||||
|
uses: actions/download-artifact@v4
|
||||||
|
with:
|
||||||
|
name: release-android-apk
|
||||||
|
|
||||||
|
- name: Download Android AAB
|
||||||
|
uses: actions/download-artifact@v4
|
||||||
|
with:
|
||||||
|
name: release-android-aab
|
||||||
|
|
||||||
|
- name: Create Gitea Release
|
||||||
|
env:
|
||||||
|
GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
|
||||||
|
TAG: ${{ gitea.ref_name }}
|
||||||
|
GITEA_BASE: https://git.westerntechnologies.duckdns.org
|
||||||
|
run: |
|
||||||
|
curl -s -X POST \
|
||||||
|
-H "Authorization: token $GITEA_TOKEN" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d "{\"tag_name\": \"$TAG\", \"name\": \"$TAG\", \"body\": \"Automated release build for $TAG\"}" \
|
||||||
|
"$GITEA_BASE/api/v1/repos/kfj001/kryz-go-flutter/releases"
|
||||||
|
|
||||||
|
- name: Upload APK to Release
|
||||||
|
env:
|
||||||
|
GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
|
||||||
|
TAG: ${{ gitea.ref_name }}
|
||||||
|
GITEA_BASE: https://git.westerntechnologies.duckdns.org
|
||||||
|
run: |
|
||||||
|
curl -s -X POST \
|
||||||
|
-H "Authorization: token $GITEA_TOKEN" \
|
||||||
|
-H "Content-Type: application/vnd.android.package-archive" \
|
||||||
|
--data-binary @app-release.apk \
|
||||||
|
"$GITEA_BASE/api/v1/repos/kfj001/kryz-go-flutter/releases/assets?name=app-release.apk&tag_name=$TAG"
|
||||||
|
|
||||||
|
- name: Upload AAB to Release
|
||||||
|
env:
|
||||||
|
GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
|
||||||
|
TAG: ${{ gitea.ref_name }}
|
||||||
|
GITEA_BASE: https://git.westerntechnologies.duckdns.org
|
||||||
|
run: |
|
||||||
|
curl -s -X POST \
|
||||||
|
-H "Authorization: token $GITEA_TOKEN" \
|
||||||
|
-H "Content-Type: application/octet-stream" \
|
||||||
|
--data-binary @app-release.aab \
|
||||||
|
"$GITEA_BASE/api/v1/repos/kfj001/kryz-go-flutter/releases/assets?name=app-release.aab&tag_name=$TAG"
|
||||||
@@ -13,7 +13,7 @@ Will build a release build for `<platform>`.
|
|||||||
## Running in Debug mode
|
## Running in Debug mode
|
||||||
With a device or devices connected:
|
With a device or devices connected:
|
||||||
|
|
||||||
`flutter run <platform>`
|
`flutter run <platform>`
|
||||||
|
|
||||||
Will execute the application in the debugging sandbox.
|
Will execute the application in the debugging sandbox.
|
||||||
|
|
||||||
@@ -31,3 +31,70 @@ dart run flutter_name_manager:rename_app --name "KRYZ Go!"
|
|||||||
dart run flutter_launcher_icons
|
dart run flutter_launcher_icons
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## CI/CD Pipeline
|
||||||
|
|
||||||
|
This project uses **Gitea Actions** for continuous integration and release automation.
|
||||||
|
|
||||||
|
### Pipeline Overview
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────┐ ┌────────┐ ┌──────────────┐ ┌──────────────┐
|
||||||
|
│ Lint │───►│ Test │───►│ Build Android │ │ Build iOS │
|
||||||
|
│ │ │ │ │ (APK + AAB) │ │ (self-hosted)│
|
||||||
|
└─────────┘ └────────┘ └──────────────┘ └──────────────┘
|
||||||
|
│ │ │
|
||||||
|
▼ ▼ ▼
|
||||||
|
dart fmt flutter test flutter build ios
|
||||||
|
flutter analyze (--no-codesign fallback)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Workflows
|
||||||
|
|
||||||
|
#### CI (`.gitea/workflows/ci.yml`)
|
||||||
|
|
||||||
|
Triggers on:
|
||||||
|
- Push to `main` or `develop`
|
||||||
|
- Pull requests targeting `main`
|
||||||
|
|
||||||
|
Stages:
|
||||||
|
1. **Lint** — `dart format --fix` + `flutter analyze --fatal-warnings`
|
||||||
|
2. **Test** — `flutter test` (coverage on main branch pushes)
|
||||||
|
3. **Build Android** — APK + AAB release builds with artifact upload
|
||||||
|
4. **Build iOS** — `flutter build ios --release --no-codesign` (runs on self-hosted macOS runner)
|
||||||
|
|
||||||
|
#### Release (`.gitea/workflows/release.yml`)
|
||||||
|
|
||||||
|
Triggers on:
|
||||||
|
- Git tags matching `v*` (e.g., `v1.0.0`)
|
||||||
|
|
||||||
|
Stages:
|
||||||
|
1. **Lint** — `dart format --set-exit-if-changed` + `flutter analyze --fatal-warnings`
|
||||||
|
2. **Test** — `flutter test`
|
||||||
|
3. **Build Android Release** — Signed APK + AAB
|
||||||
|
4. **Build iOS Release** — Signed IPA (or `--no-codesign` fallback)
|
||||||
|
5. **Publish Release** — Creates Gitea release + uploads artifacts
|
||||||
|
|
||||||
|
### Configuration
|
||||||
|
|
||||||
|
| Secret | Required | Description |
|
||||||
|
|---|---|---|
|
||||||
|
| `ANDROID_KEYSTORE_BASE64` | No | Base64-encoded Android release keystore |
|
||||||
|
| `ANDROID_KEYSTORE_PASS` | No | Keystore password |
|
||||||
|
| `ANDROID_KEY_ALIAS` | No | Key alias |
|
||||||
|
| `ANDROID_KEY_PASS` | No | Key password |
|
||||||
|
| `APPLE_CERTIFICATE_P12` | No | Base64-encoded Apple signing certificate |
|
||||||
|
| `APPLE_CERTIFICATE_PASS` | No | Certificate password |
|
||||||
|
| `APPLE_PROVISION_PROFILE` | No | Base64-encoded provisioning profile |
|
||||||
|
| `GITEA_TOKEN` | Yes (Release) | Token for creating Gitea releases |
|
||||||
|
|
||||||
|
Without signing secrets, builds use debug keys or `--no-codesign`.
|
||||||
|
|
||||||
|
### CI Status
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
### Troubleshooting
|
||||||
|
|
||||||
|
- **Stubs missing**: The `ci_stub_gen.py` script auto-generates `lib/generated/*.dart` stubs when `theme.json` is absent.
|
||||||
|
- **macOS runner unavailable**: The iOS stage uses `self-hosted` label. Ensure a macOS Gitea runner is registered.
|
||||||
|
- **Format checks**: CI uses `dart format --fix` (auto-fix). Release uses `--set-exit-if-changed` (gate).
|
||||||
|
|||||||
@@ -12,6 +12,13 @@ dependencies {
|
|||||||
implementation("androidx.media:media:1.7.0")
|
implementation("androidx.media:media:1.7.0")
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Load release signing properties if key.properties exists (set by CI pipeline)
|
||||||
|
val keystorePropertiesFile = rootProject.file("key.properties")
|
||||||
|
val keystoreProperties = java.util.Properties()
|
||||||
|
if (keystorePropertiesFile.exists()) {
|
||||||
|
keystoreProperties.load(java.io.FileInputStream(keystorePropertiesFile))
|
||||||
|
}
|
||||||
|
|
||||||
android {
|
android {
|
||||||
namespace = "com.example.kryz_go_flutter"
|
namespace = "com.example.kryz_go_flutter"
|
||||||
compileSdk = flutter.compileSdkVersion
|
compileSdk = flutter.compileSdkVersion
|
||||||
@@ -37,11 +44,25 @@ android {
|
|||||||
versionName = flutter.versionName
|
versionName = flutter.versionName
|
||||||
}
|
}
|
||||||
|
|
||||||
|
signingConfigs {
|
||||||
|
create("release") {
|
||||||
|
if (keystorePropertiesFile.exists()) {
|
||||||
|
keyAlias = keystoreProperties["keyAlias"] as String
|
||||||
|
keyPassword = keystoreProperties["keyPassword"] as String
|
||||||
|
storeFile = file(keystoreProperties["storeFile"] as String)
|
||||||
|
storePassword = keystoreProperties["storePassword"] as String
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
buildTypes {
|
buildTypes {
|
||||||
release {
|
release {
|
||||||
// TODO: Add your own signing config for the release build.
|
// Use release signing if key.properties exists, otherwise fall back to debug.
|
||||||
// Signing with the debug keys for now, so `flutter run --release` works.
|
if (keystorePropertiesFile.exists()) {
|
||||||
signingConfig = signingConfigs.getByName("debug")
|
signingConfig = signingConfigs.getByName("release")
|
||||||
|
} else {
|
||||||
|
signingConfig = signingConfigs.getByName("debug")
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,99 @@
|
|||||||
|
#!/usr/bin/env python3
|
||||||
|
"""Generate stub lib/generated/*.dart files so flutter analyze passes
|
||||||
|
before the whitelabel build script has been run.
|
||||||
|
|
||||||
|
This is only needed for CI lint gates. The real build generates these
|
||||||
|
from theme.json via build_whitelabel.py.
|
||||||
|
"""
|
||||||
|
|
||||||
|
import os
|
||||||
|
import sys
|
||||||
|
|
||||||
|
PROJECT_ROOT = os.path.dirname(os.path.abspath(__file__))
|
||||||
|
GENERATED_DIR = os.path.join(PROJECT_ROOT, "lib", "generated")
|
||||||
|
|
||||||
|
DEFAULT_APP_CONFIG = '''// GENERATED STUB — DO NOT EDIT.
|
||||||
|
// This file is replaced by `python3 build_whitelabel.py` during actual builds.
|
||||||
|
// Exists only so that `flutter analyze` passes before whitelabel generation.
|
||||||
|
|
||||||
|
class AppConfig {
|
||||||
|
static const String callsign = 'KRYZ';
|
||||||
|
static const String appName = 'KRYZ Go';
|
||||||
|
static const String tagline = '';
|
||||||
|
static const String frequency = '';
|
||||||
|
static const String streamUrl = '';
|
||||||
|
static const String? metadataUrl = null;
|
||||||
|
static const String defaultTitle = 'KRYZ Live Stream';
|
||||||
|
static const String defaultArtist = 'KRYZ Radio';
|
||||||
|
}
|
||||||
|
'''
|
||||||
|
|
||||||
|
DEFAULT_THEME_COLORS = '''// GENERATED STUB — DO NOT EDIT.
|
||||||
|
// This file is replaced by `python3 build_whitelabel.py` during actual builds.
|
||||||
|
// Exists only so that `flutter analyze` passes before whitelabel generation.
|
||||||
|
|
||||||
|
import 'package:flutter/material.dart';
|
||||||
|
import 'package:kryz_go_flutter/app_theme_business_object.dart';
|
||||||
|
|
||||||
|
class GeneratedThemeColors {
|
||||||
|
static const AppThemeColors lightColors = AppThemeColors(
|
||||||
|
headingColor: Color(0xFF1E293B),
|
||||||
|
accentColor: Color(0xFF6366F1),
|
||||||
|
scaffoldGradientStart: Color(0xFFF8F9FA),
|
||||||
|
scaffoldGradientEnd: Color(0xFFE9ECEF),
|
||||||
|
shellSurface: Color(0xFFFDFDFD),
|
||||||
|
shellBorder: Color(0xFFDEE2E6),
|
||||||
|
mutedText: Color(0xFF6C757D),
|
||||||
|
textOnDark: Color(0xFFFFFFFF),
|
||||||
|
textOnDarkSecondary: Color(0xFFE9ECEF),
|
||||||
|
controlsGradientStart: Color(0xFF1E293B),
|
||||||
|
controlsGradientEnd: Color(0xFF334155),
|
||||||
|
controlsShadow: Color(0x24000000),
|
||||||
|
bodyText: Color(0xFF333333),
|
||||||
|
cardSurface: Color(0x14FFFFFF),
|
||||||
|
cardBorder: Color(0x1FFFFFFF),
|
||||||
|
successColor: Color(0xFF28A745),
|
||||||
|
dangerColor: Color(0xFFDC3545),
|
||||||
|
);
|
||||||
|
|
||||||
|
static const AppThemeColors darkColors = AppThemeColors(
|
||||||
|
headingColor: Color(0xFF8B949E),
|
||||||
|
accentColor: Color(0xFF7C83FF),
|
||||||
|
scaffoldGradientStart: Color(0xFF0D1117),
|
||||||
|
scaffoldGradientEnd: Color(0xFF161B22),
|
||||||
|
shellSurface: Color(0xFF161B22),
|
||||||
|
shellBorder: Color(0xFF30363D),
|
||||||
|
mutedText: Color(0xFF6C757D),
|
||||||
|
textOnDark: Color(0xFFFFFFFF),
|
||||||
|
textOnDarkSecondary: Color(0xFFE9ECEF),
|
||||||
|
controlsGradientStart: Color(0xFF161B22),
|
||||||
|
controlsGradientEnd: Color(0xFF1E293B),
|
||||||
|
controlsShadow: Color(0x37000000),
|
||||||
|
bodyText: Color(0xFFC9D1D9),
|
||||||
|
cardSurface: Color(0x14FFFFFF),
|
||||||
|
cardBorder: Color(0x1FFFFFFF),
|
||||||
|
successColor: Color(0xFF28A745),
|
||||||
|
dangerColor: Color(0xFFDC3545),
|
||||||
|
);
|
||||||
|
}
|
||||||
|
'''
|
||||||
|
|
||||||
|
|
||||||
|
def main():
|
||||||
|
os.makedirs(GENERATED_DIR, exist_ok=True)
|
||||||
|
|
||||||
|
paths = [
|
||||||
|
(os.path.join(GENERATED_DIR, "app_config.dart"), DEFAULT_APP_CONFIG),
|
||||||
|
(os.path.join(GENERATED_DIR, "theme_colors.dart"), DEFAULT_THEME_COLORS),
|
||||||
|
]
|
||||||
|
|
||||||
|
for path, content in paths:
|
||||||
|
with open(path, "w") as f:
|
||||||
|
f.write(content)
|
||||||
|
print(f"Generated {path}")
|
||||||
|
|
||||||
|
print(f"Generated stubs in {GENERATED_DIR}")
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == "__main__":
|
||||||
|
main()
|
||||||
Reference in New Issue
Block a user