Building & Deploying

ใน React การ deploy หมายถึงการรัน npm run build เพื่อสร้าง static folder dist/ แล้วนำขึ้น Vercel, Netlify หรือ S3 Flutter มีสาม build targets — Android (APK/AAB), iOS (IPA) และ web — แต่ละอันมีคำสั่งและข้อกำหนด signing ของตัวเอง logic ของ CI pipeline แทบจะเหมือนกับที่คุณเขียนสำหรับ React เพียงแค่เปลี่ยน action steps

Build commands

# Android
flutter build apk              # Debug APK (for testing)
flutter build apk --release    # Release APK (signed)
flutter build appbundle        # Android App Bundle (Play Store preferred)

# iOS (requires macOS + Xcode)
flutter build ipa              # iOS Archive for App Store / TestFlight
flutter build ipa --export-method ad-hoc  # Ad-hoc distribution

# Web
flutter build web              # Output to build/web/
flutter build web --release    # Minified production build

# Desktop
flutter build macos
flutter build windows
flutter build linux

web build จะ output ไปที่ build/web/ — เป็น static folder เหมือนกับ dist/ ของ Vite คุณ deploy ไปที่ CDN ใดก็ได้โดยไม่ต้องแก้ไขอะไร

Release signing — Android

Android release builds ต้องมีการ sign ด้วย keystore เปรียบเหมือน code-signing ในการพัฒนา app native — builds ที่ไม่ได้ sign จะไม่สามารถ distribute ผ่าน Play Store ได้

สร้าง keystore ด้วย Java keytool:

keytool -genkey -v -keystore ~/upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload

จากนั้นสร้าง android/key.properties เพื่อ reference keystore:

storePassword=<your-store-password>
keyPassword=<your-key-password>
keyAlias=upload
storeFile=<path-to>/upload-keystore.jks

สุดท้าย reference key.properties ใน android/app/build.gradle เพื่อให้ release build ดึง signing config มาโดยอัตโนมัติ

ปฏิบัติกับ key.properties และ .jks เหมือนกับ .env ไฟล์ที่มี secrets — อย่า commit ลง git เด็ดขาด เพิ่มทั้งคู่ลงใน .gitignore

Release signing — iOS

iOS signing ต้องการ Apple Developer account, provisioning profile และ signing certificate ที่จัดการผ่าน Xcode flutter build ipa สร้าง .xcarchive แล้ว export เป็น .ipa วิธีที่ง่ายที่สุดคือเปิด “Automatically manage signing” ใน Xcode ซึ่งจัดการ profile และ certificate ให้โดยอัตโนมัติ

flutter build ipa รับ flag --export-method เพื่อควบคุม distribution channel: app-store สำหรับ App Store/TestFlight, ad-hoc สำหรับ direct device distribution

Web deploy

# Firebase Hosting
firebase deploy --only hosting

# Or drag-drop build/web/ to Netlify's deploy UI
# Or push to Vercel via the Vercel CLI

output ของ build/web/ คือ static site ปกติ — index.html, compiled JavaScript และ assets ที่ประกาศใน pubspec.yaml ไม่ต้องมี server

GitHub Actions CI

React CI pipeline ติดตั้ง Node, รัน npm ci, lint, test และ build Flutter CI pipeline ทำเช่นเดียวกันโดยใช้ subosito/flutter-action แทน actions/setup-node

name: React CI
on:
  push:
    branches: [main]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: actions/setup-node@v7
        with:
          node-version: '24'
      - run: npm ci
      - run: npm run lint
      - run: npm test -- --watchAll=false
      - run: npm run build

name: Flutter CI
on:
  push:
    branches: [main]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: subosito/flutter-action@v2
        with:
          flutter-version: '3.47.0'
          channel: 'stable'
      - run: flutter pub get
      - run: flutter analyze
      - run: flutter test --coverage
      - run: flutter build web --release

ตัวอย่าง workflow ที่ครบถ้วนพร้อม branch triggers สำหรับทั้ง main และ feature branches:

name: Flutter CI

on:
  push:
    branches: [main, dev]
  pull_request:
    branches: [main]

jobs:
  build-and-test:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v7

      - uses: subosito/flutter-action@v2
        with:
          flutter-version: '3.47.0'
          channel: 'stable'

      - name: Install dependencies
        run: flutter pub get

      - name: Analyze
        run: flutter analyze

      - name: Run tests
        run: flutter test --coverage

      - name: Build web
        run: flutter build web --release

🔀 npm run build → flutter build

Platform ระบุชัดเจน. npm run build เสมอ target web flutter build ต้องการ platform subcommand (apk, ipa, web, macos ฯลฯ) ไม่มีคำสั่งเดียวที่ build ทุก targets พร้อมกัน
appbundle แทน apk สำหรับ Play Store. Android App Bundle ให้ Google Play ส่ง APK เฉพาะอุปกรณ์ ช่วยลดขนาด download 15–30% ใช้ flutter build apk สำหรับทดสอบ local และ sideloading; ใช้ flutter build appbundle สำหรับ Play Store
Signing เป็นข้อกำหนดเบื้องต้นสำหรับ release builds. npm run build สร้าง artifact ที่ deploy ได้ทันที flutter build apk --release และ flutter build ipa ทั้งคู่จะล้มเหลวหรือสร้าง artifacts ที่ invalid หาก signing ไม่ได้ตั้งค่าไว้ วางแผนสิ่งนี้ก่อน release แรก
subosito/flutter-action แทน actions/setup-node. action นี้ pin Flutter SDK version และ channel เพื่อให้ CI builds reproducible ใช้ channel: 'stable' สำหรับ production pipelines
flutter pub get แทน npm ci. ไม่มี flag --frozen-lockfile equivalent; flutter pub get ใช้ pubspec.lock เสมอเมื่อมีอยู่ จึง behave เหมือนกับ npm ci ในแง่ reproducibility
flutter analyze แทนทั้ง npm run lint และ npx tsc --noEmit. คำสั่งเดียว ขั้นตอนเดียว
project Android ใช้ Kotlin ที่มากับ Flutter. ตั้งแต่ Flutter 3.44 flutter create ไม่ได้ใส่เวอร์ชันของ Kotlin Gradle plugin แยกเข้า project ของคุณอีกแล้ว SDK เป็นคนจัดให้ project เก่าที่ยังถือเวอร์ชัน Kotlin ของตัวเองอยู่ยัง build ได้ แต่ flutter doctor และ build log จะชี้ไปที่ migration เมื่อเวอร์ชันเริ่มไม่ตรงกัน