การจัดการคอนฟิกูเรชันในการพัฒนามือถือ: คืออะไร มีตัวเลือกอะไรบ้าง และวิธีตั้งค่า

การจัดการคอนฟิกูเรชันใน Android: Build Variant และ build.gradle

Build Variant — การรวมกันของ Build Type (debug/release/staging) และ Product Flavor (free/paid, demo/full) Gradle สร้าง variant โดยอัตโนมัติสำหรับแต่ละชุด: freeDebug, freeRelease, paidDebug, paidRelease แต่ละ variant สามารถมีโค้ด ทรัพยากร และ dependencies ของตัวเองได้ — นี่คือพื้นฐานของการจัดการคอนฟิกูเรชันในแอปมือถือบน Android

Build Variant เทียบกับ Product Flavor

Build Type — การตั้งค่าบิลด์: เปิดใช้งานการดีบักหรือไม่ การเซ็นชื่อ การปรับแต่ง ProGuard debug โดยค่าเริ่มต้นประกอบด้วย debuggable=true, release — minifyEnabled=true

Product Flavor — รูปแบบแอป: ฟรี (free), เสียเงิน (paid), สาธิต (demo) Flavor สามารถมี applicationId, ทรัพยากร, SDK dependencies ที่แตกต่างกันได้

// build.gradle — การกำหนดค่า product flavor ของ Android
android {
    productFlavors {
        free {
            applicationId "com.example.app.free"
            versionName "1.0-free"
        }
        paid {
            applicationId "com.example.app.paid"
            versionName "1.0-paid"
        }
    }
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt')
        }
    }
}

ตัวอย่างสร้างสอง flavor: free และ paid applicationId ที่แยกต่างหากถูกตั้งค่าสำหรับ free — ซึ่งช่วยให้ติดตั้งทั้งสองแอปบนอุปกรณ์เครื่องเดียวได้ BuildConfig ถูกสร้างขึ้นสำหรับแต่ละ variant: BuildConfig.FLAVOR = "free", BuildConfig.BUILD_TYPE = "debug" ใช้ BuildConfig ในโค้ดสำหรับตรรกะแบบมีเงื่อนไข

settings.gradle และ Gradle KTS

settings.gradle — ไฟล์ Gradle ระดับรากที่อธิบายโมดูลของโปรเจกต์

Gradle KTS — ทางเลือกของ Groovy ที่ใช้ Kotlin DSL KTS ให้การเติมข้อความอัตโนมัติใน Android Studio และการตรวจสอบชนิด ขอแนะนำสำหรับโปรเจกต์ใหม่

การจัดการคอนฟิกูเรชันใน iOS: Scheme และ .xcconfig

การจัดการคอนฟิกูเรชัน ใน iOS สร้างขึ้นบน Scheme — การกำหนดค่า Xcode ที่กำหนดว่าอะไรและอย่างไรที่จะบิลด์: Build Configuration (Debug/Release), การทดสอบ, การวิเคราะห์, การเก็บถาวร Scheme สามารถทำซ้ำสำหรับสภาพแวดล้อมต่างๆ (Development, Staging, Production) Scheme ถูกเก็บไว้ในไฟล์ .xcscheme ในโฟลเดอร์ xcshareddata

ไฟล์ .xcconfig

.xcconfig — ไฟล์กำหนดค่า Xcode ที่เก็บการตั้งค่าบิลด์ในรูปแบบข้อความ สำหรับการจัดการคอนฟิกูเรชันแอปมือถือ iOS ใช้ .xcconfig: การควบคุมเวอร์ชันใน Git, การใช้ซ้ำระหว่างโปรเจกต์, การตั้งค่าด้วยตนเองน้อยลง ใน .xcconfig กำหนด SWIFT_ACTIVE_COMPILATION_CONDITIONS, PRODUCT_BUNDLE_IDENTIFIER, CODE_SIGN_IDENTITY

Info.plist — ไฟล์เมตาดาต้าของแอป เก็บเวอร์ชัน ตัวระบุ สิทธิ์ Info.plist สามารถแตกต่างกันสำหรับแต่ละ Scheme — ผ่าน Info.plist File ใน Build Settings

AndroidManifest.xml — รายการที่เทียบเท่าสำหรับ Android: เก็บสิทธิ์ คอมโพเนนต์ เมตาดาต้า

Scheme เทียบกับ Build Configuration

Scheme — สถานการณ์บิลด์ (จะทำอะไร) Build Configuration — ชุดการตั้งค่า (จะทำอย่างไร) หนึ่ง Scheme ใช้หนึ่ง Build Configuration (Debug หรือ Release) สำหรับ CI/CD: กำหนดค่า Archive action เป็น Release และ Test action เป็น Debug ใน Scheme เดียวกัน

การจัดการคอนฟิกูเรชันใน Flutter และ React Native: pubspec.yaml, Podfile, .env

pubspec.yaml — ไฟล์กำหนดค่าโปรเจกต์ Flutter ประกอบด้วย dependencies, เวอร์ชัน, ทรัพยากร รองรับตัวแปรสภาพแวดล้อมผ่าน --dart-define

Podfile — ตัวจัดการ dependencies CocoaPods สำหรับ iOS กำหนดเวอร์ชันไลบรารีและแพลตฟอร์ม

.env — ไฟล์ที่มีตัวแปรสภาพแวดล้อมสำหรับทุกแพลตฟอร์ม Flutter และ React Native ใช้แนวทางที่แตกต่างกันสำหรับการจัดการคอนฟิกูเรชัน: dart-define ใน Flutter, react-native-config ใน React Native การจัดการคอนฟิกูเรชันในโปรเจกต์ข้ามแพลตฟอร์มเกี่ยวข้องกับเครื่องมือต่างๆ ขึ้นอยู่กับสแต็ก

.env และตัวแปรสภาพแวดล้อม

.env — ไฟล์ข้อความที่มีคู่ คีย์=ค่า อย่า commit ไปยัง Git (เพิ่มใน .gitignore) สำหรับ Flutter — flutter_dotenv, สำหรับ iOS — Config.xcconfig พร้อม #include, สำหรับ Android — BuildConfig ตัวแปร env: API_URL, SENTRY_DSN, APP_SECRET ในการจัดการคอนฟิกูเรชันในการพัฒนามือถือ .env เป็นมาตรฐานโดยพฤตินัยสำหรับการเก็บความลับภายนอกที่เก็บ

Podfile และ pubspec.yaml

Podfile อธิบาย dependencies ของ CocoaPods และแพลตฟอร์ม (platform :ios, '15.0') pubspec.yaml สำหรับ Flutter — dependencies และ dev_dependencies ทั้งสองรองรับ dependencies แบบมีเงื่อนไข: pod 'Analytics', :configs => ['Release'] หรือ flutter pub add --flavor free ที่ IT Sectr เราใช้ .env + BuildConfig สำหรับความลับและ Podfile สำหรับ dependencies ดั้งเดิมในโปรเจกต์มือถือ

ตารางแสดงความแตกต่างหลักใน การจัดการคอนฟิกูเรชัน ระหว่างแพลตฟอร์มมือถือ Android ให้ความยืดหยุ่นมากกว่าผ่าน Build Variant iOS เรียบง่ายกว่าแต่ยืดหยุ่นน้อยกว่า Flutter รวมศูนย์คอนฟิกูเรชันใน dart-define แต่ dependencies ดั้งเดิมยังคงต้องกำหนดค่า Podfile/build.gradle

การคอมไพล์แบบมีเงื่อนไขในการจัดการคอนฟิกูเรชัน

การคอมไพล์แบบมีเงื่อนไข — การรวมหรือแยกโค้ดในขั้นตอนการคอมไพล์ขึ้นอยู่กับแฟล็ก นี่เป็นส่วนหนึ่งของการจัดการคอนฟิกูเรชัน: มันช่วยให้สามารถฝังเครื่องมือดีบัก (การบันทึก, ตัวตรวจสอบ) ในบิลด์ debug และลบออกจาก release การนำไปใช้งานแตกต่างกันไปตามแพลตฟอร์ม

การคอมไพล์แบบมีเงื่อนไขใน Swift

#if DEBUG — คำสั่งพรีโปรเซสเซอร์ของ Swift โค้ดภายในบล็อกจะถูกคอมไพล์เฉพาะในการกำหนดค่า Debug เท่านั้น แฟล็กอื่นๆ: #if !RELEASE, #if targetEnvironment(simulator) Active Compilation Conditions ใน Build Settings — เพิ่มแฟล็กที่กำหนดเองผ่าน -D FLAG_NAME การจัดการคอนฟิกูเรชันบิลด์ผ่านเงื่อนไขการคอมไพล์เป็นแนวทางปฏิบัติมาตรฐานใน iOS

การคอมไพล์แบบมีเงื่อนไขใน Kotlin

BuildConfig.DEBUG — ฟิลด์บูลีน, true ในบิลด์ debug BuildConfig ถูกสร้างโดยอัตโนมัติโดย Gradle สำหรับแฟล็กที่กำหนดเอง ใช้ buildConfigField ใน build.gradle: buildConfigField "boolean", "REPORT_CRASHES", "true" ในโค้ด: if (BuildConfig.REPORT_CRASHES) { ... }

การคอมไพล์แบบมีเงื่อนไขใน Flutter

dart-define — แฟล็กการคอมไพล์ของ Flutter: flutter run --dart-define=ENV=staging ในโค้ด: const env = String.fromEnvironment('ENV', defaultValue: 'production') สำหรับการบิลด์แอปมือถือแบบมีเงื่อนไข ใช้ปลั๊กอิน build_runner พร้อมการสร้างโค้ด