Terakhir diperbarui: 13 November 2026

Bahasa Indonesia | English

Pemeriksaan manual yang berulang mudah terlewat dan sulit direproduksi. Pada codelab ini, Anda akan menyiapkan pipeline CI/CD untuk menjalankan pemeriksaan, pengujian, dan build Flutter secara konsisten menggunakan GitHub Actions.

Tujuan pembelajaran

Persiapan

1. CI dan CD

Continuous integration (CI) menjalankan pemeriksaan otomatis saat perubahan diajukan atau di-push. Continuous delivery/deployment (CD) mengotomatiskan penyiapan atau pengiriman rilis. Pipeline yang baik membuat langkah penting berulang dan hasilnya dapat ditinjau.

  1. Commit atau pull request memicu workflow.
  2. Runner mengambil source code dan menyiapkan Flutter.
  3. Format, analisis statis, dan test dijalankan.
  4. Jika pemeriksaan lulus, aplikasi dibangun dan artefak disimpan.

2. Event dan permission

Gunakan pull_request untuk memeriksa perubahan sebelum merge dan push untuk memeriksa branch utama. Berikan permission minimum. Pull request dari fork tidak mendapat akses ke GitHub Secrets repository.

1. Tambahkan file workflow

Di root project, buat .github/workflows/flutter-ci.yml. Sesuaikan nama branch jika branch utama Anda bukan main.

name: Flutter CI

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
  workflow_dispatch:

permissions:
  contents: read

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

jobs:
  test-and-build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: subosito/flutter-action@v2
        with:
          channel: stable
      - run: flutter pub get
      - run: dart format --output=none --set-exit-if-changed .
      - run: flutter analyze --fatal-infos
      - run: flutter test --coverage

2. Periksa secara lokal

Sebelum push, jalankan perintah format, analisis, dan test yang sama pada project Anda. Perbaiki kegagalan; jangan menghapus pemeriksaan agar workflow terlihat hijau.

1. Tambahkan langkah build

Setelah test lulus, tambahkan perintah berikut sebagai step di job yang sama:

      - run: flutter build apk --release
      - run: flutter build appbundle --release
      - uses: actions/upload-artifact@v4
        with:
          name: android-builds
          path: |
            build/app/outputs/flutter-apk/app-release.apk
            build/app/outputs/bundle/release/app-release.aab
          if-no-files-found: error
          retention-days: 7

1. Versioning

Di pubspec.yaml, versi seperti 1.2.0+15 berarti versi aplikasi 1.2.0 dan build number 15. Ikuti semantic versioning: major untuk perubahan tidak kompatibel, minor untuk fitur kompatibel, dan patch untuk perbaikan. Naikkan build number untuk setiap unggahan baru.

Gunakan tag seperti v1.2.0 untuk menghubungkan source, log pipeline, dan artefak. Pastikan tag menunjuk pada commit yang sudah lolos pemeriksaan.

2. Rahasia dan konfigurasi

Untuk rilis bertanda tangan, ikuti panduan resmi Flutter untuk signing dan injeksikan material sensitif hanya pada workflow rilis yang dibatasi. Jangan menaruh keystore produksi pada workflow pull request.

1. Jalankan workflow

  1. Commit file workflow dan push ke GitHub.
  2. Buka tab Actions dan pilih run yang sesuai.
  3. Tinjau tiap step. Pastikan kegagalan test membuat job gagal.
  4. Unduh artefak dan catat commit yang menghasilkan file tersebut.

2. Tugas

  1. Tambahkan workflow CI ke project Flutter Anda dengan format, analisis, dan test.
  2. Bangun APK dan AAB serta simpan keduanya sebagai artefak.
  3. Jalankan workflow melalui pull request atau push ke branch utama; sertakan bukti hasil serta commit.
  4. Dokumentasikan versi berikutnya, pemeriksaan yang dijalankan, dan risiko keamanan yang masih perlu ditangani.

Refleksi

Referensi pendukung