Quản lý cấu hình trong phát triển di động: nó là gì, các tùy chọn và cách thiết lập

Quản lý cấu hình trong Android: Build Variant và build.gradle

Build Variant — sự kết hợp giữa Build Type (debug/release/staging) và Product Flavor (free/paid, demo/full). Gradle tự động tạo variant cho mỗi tổ hợp: freeDebug, freeRelease, paidDebug, paidRelease. Mỗi variant có thể có mã, tài nguyên và phụ thuộc riêng — đây là nền tảng của quản lý cấu hình trong ứng dụng di động trên Android.

Build Variant vs Product Flavor

Build Type — cài đặt build: có bật gỡ lỗi không, ký, tối ưu hóa ProGuard. debug mặc định chứa debuggable=true, release — minifyEnabled=true.

Product Flavor — biến thể ứng dụng: miễn phí (free), trả phí (paid), demo. Các flavor có thể có applicationId, tài nguyên, phụ thuộc SDK khác nhau.

// build.gradle — cấu hình flavor sản phẩm 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')
        }
    }
}

Ví dụ tạo hai flavor: free và paid. Một applicationId riêng được đặt cho free — điều này cho phép cài đặt cả hai ứng dụng trên một thiết bị. BuildConfig được tạo cho mỗi variant: BuildConfig.FLAVOR = "free", BuildConfig.BUILD_TYPE = "debug". Sử dụng BuildConfig trong mã cho logic có điều kiện.

settings.gradle và Gradle KTS

settings.gradle — tệp Gradle gốc mô tả các mô-đun của dự án.

Gradle KTS — một giải pháp thay thế cho Groovy sử dụng Kotlin DSL. KTS cung cấp tính năng tự động hoàn thành trong Android Studio và kiểm tra kiểu. Được khuyến nghị cho các dự án mới.

Quản lý cấu hình trong iOS: Scheme và .xcconfig

Quản lý cấu hình trong iOS dựa trên Scheme — cấu hình Xcode xác định cái gì và làm thế nào để xây dựng: Build Configuration (Debug/Release), kiểm thử, phân tích, lưu trữ. Scheme có thể được nhân bản cho các môi trường khác nhau (Development, Staging, Production). Scheme được lưu trữ trong tệp .xcscheme trong thư mục xcshareddata.

Tệp .xcconfig

.xcconfig — tệp cấu hình Xcode lưu trữ cài đặt build dưới dạng văn bản. Để quản lý cấu hình ứng dụng di động, iOS sử dụng .xcconfig: kiểm soát phiên bản trong Git, tái sử dụng giữa các dự án, ít cài đặt thủ công hơn. Trong .xcconfig, SWIFT_ACTIVE_COMPILATION_CONDITIONS, PRODUCT_BUNDLE_IDENTIFIER, CODE_SIGN_IDENTITY được thiết lập.

Info.plist — tệp siêu dữ liệu của ứng dụng. Nó lưu trữ phiên bản, định danh, quyền. Info.plist có thể khác nhau cho mỗi Scheme — thông qua Info.plist File trong Build Settings.

AndroidManifest.xml — tương đương trên Android: lưu trữ quyền, thành phần, siêu dữ liệu.

Scheme vs Build Configuration

Scheme — kịch bản build (làm gì). Build Configuration — tập hợp cài đặt (làm như thế nào). Một Scheme sử dụng một Build Configuration (Debug hoặc Release). Cho CI/CD: cấu hình hành động Archive thành Release và hành động Test thành Debug trong cùng một Scheme.

Quản lý cấu hình trong Flutter và React Native: pubspec.yaml, Podfile, .env

pubspec.yaml — tệp cấu hình dự án Flutter. Chứa các phụ thuộc, phiên bản, tài nguyên. Hỗ trợ biến môi trường thông qua --dart-define.

Podfile — trình quản lý phụ thuộc CocoaPods cho iOS. Xác định phiên bản thư viện và nền tảng.

.env — tệp với các biến môi trường cho tất cả nền tảng. Flutter và React Native sử dụng cách tiếp cận khác nhau cho quản lý cấu hình: dart-define trong Flutter, react-native-config trong React Native. Quản lý cấu hình trong các dự án đa nền tảng liên quan đến các công cụ khác nhau tùy theo stack.

.env và Biến môi trường

.env — tệp văn bản với các cặp khóa=giá trị. Không commit vào Git (thêm vào .gitignore). Cho Flutter — flutter_dotenv, cho iOS — Config.xcconfig với #include, cho Android — BuildConfig. Biến env: API_URL, SENTRY_DSN, APP_SECRET. Trong quản lý cấu hình phát triển di động, .env là tiêu chuẩn thực tế để lưu trữ bí mật bên ngoài kho lưu trữ.

Podfile và pubspec.yaml

Podfile mô tả phụ thuộc CocoaPods và nền tảng (platform :ios, '15.0'). pubspec.yaml cho Flutter — dependencies và dev_dependencies. Cả hai đều hỗ trợ phụ thuộc có điều kiện: pod 'Analytics', :configs => ['Release'] hoặc flutter pub add --flavor free. Tại IT Sectr, chúng tôi sử dụng .env + BuildConfig cho bí mật và Podfile cho phụ thuộc gốc trong các dự án di động.

Bảng cho thấy sự khác biệt chính trong quản lý cấu hình giữa các nền tảng di động. Android cung cấp sự linh hoạt hơn thông qua Build Variant. iOS đơn giản hơn nhưng kém linh hoạt hơn. Flutter tập trung cấu hình trong dart-define, nhưng các phụ thuộc gốc vẫn yêu cầu cấu hình Podfile/build.gradle.

Biên dịch có điều kiện trong quản lý cấu hình

Biên dịch có điều kiện — bao gồm hoặc loại trừ mã ở giai đoạn biên dịch tùy theo cờ. Đây là một phần của quản lý cấu hình: nó cho phép nhúng các công cụ gỡ lỗi (ghi log, thanh tra) trong bản build debug và loại bỏ chúng khỏi bản phát hành. Việc triển khai khác nhau giữa các nền tảng.

Biên dịch có điều kiện trong Swift

#if DEBUG — chỉ thị tiền xử lý Swift. Mã bên trong khối chỉ được biên dịch trong cấu hình Debug. Các cờ khác: #if !RELEASE, #if targetEnvironment(simulator). Active Compilation Conditions trong Build Settings — thêm cờ tùy chỉnh qua -D FLAG_NAME. Quản lý cấu hình build thông qua điều kiện biên dịch là thực tiễn tiêu chuẩn trong iOS.

Biên dịch có điều kiện trong Kotlin

BuildConfig.DEBUG — trường boolean, true trong bản build debug. BuildConfig được Gradle tự động tạo ra. Đối với cờ tùy chỉnh, sử dụng buildConfigField trong build.gradle: buildConfigField "boolean", "REPORT_CRASHES", "true". Trong mã: if (BuildConfig.REPORT_CRASHES) { ... }.

Biên dịch có điều kiện trong Flutter

dart-define — cờ biên dịch Flutter: flutter run --dart-define=ENV=staging. Trong mã: const env = String.fromEnvironment('ENV', defaultValue: 'production'). Để xây dựng ứng dụng di động có điều kiện, sử dụng plugin build_runner với tạo mã.