Fastlane — định nghĩa, công cụ và tự động hóa build ứng dụng di động

Fastlane là gì và nó tự động hóa build di động như thế nào

Fastlane là công cụ tự động hóa build di động, được viết bằng Ruby và phân phối dưới giấy phép MIT. Nó tự động hóa các tác vụ thường ngày của nhà phát triển di động: build ứng dụng, chạy kiểm thử, tạo ảnh chụp màn hình, ký mã và tải tập tin nhị phân lên App Store hoặc Google Play. Thay vì 15–20 lệnh thủ công, nhà phát triển chạy một lệnh fastlane duy nhất với tên kịch bản.

Fastlane hoạt động như một lớp bọc trên các tiện ích Xcode (xcodebuild, xcrun) và Android SDK (gradlew, apksigner, bundletool), cung cấp giao diện thống nhất cho cả hai nền tảng. Điều này đặc biệt có giá trị đối với các nhóm duy trì cả phiên bản iOS và Android của cùng một ứng dụng — các Fastfile giống nhau có thể mô tả build cho cả hai nền tảng với sự khác biệt tối thiểu trong tham số.

Theo GitHub, Fastlane có hơn 39.000 sao và là tiêu chuẩn tự động hóa trong phát triển di động. Công cụ này được cộng đồng và Google duy trì — Fastlane được tích hợp vào Firebase như phương pháp được khuyến nghị để phân phối ứng dụng Android lên Google Play Console.

Kiến trúc Fastlane: Actions, Lanes và công cụ

Kiến trúc của Fastlane được xây dựng trên ba cấp độ: actions (lệnh cơ bản), lanes (kịch bản) và công cụ (tiện ích chuyên dụng). Actions là các hàm riêng lẻ của Fastlane, mỗi hàm thực hiện một hành động cụ thể: tạo ảnh chụp màn hình, build IPA, tải lên TestFlight. Lanes kết hợp nhiều actions thành một kịch bản tuần tự được mô tả trong Fastfile.

Fastlane Actions

Actions là các khối xây dựng của Fastlane. Mỗi action nhận tham số và thực hiện một tác vụ duy nhất. Ví dụ, action gym build ứng dụng iOS, scan chạy kiểm thử, pilot tải build lên TestFlight. Fastlane có hơn 200 actions tích hợp sẵn, tài liệu cho mỗi action có sẵn qua lệnh fastlane action [tên].

Nếu các actions tích hợp sẵn không đủ, nhà phát triển có thể tạo custom action bằng Ruby và kết nối nó trong Fastfile. Các custom action được phân phối qua plugin Fastlane, được xuất bản trên Rubygems và cài đặt qua tập tin FastfilePlugin trong thư mục gốc của dự án.

Lanes và sự kết hợp của chúng

Lane là một kịch bản tự động hóa có tên kết hợp nhiều actions thành một chuỗi logic. Lane có thể gọi các lanes khác (private lanes), truyền tham số và xử lý lỗi. Điều này cho phép xây dựng hệ thống phân cấp kịch bản: lane build cơ bản, lane triển khai, lane chu trình CI/CD đầy đủ.

Công cụ Fastlane chính: scan, gym, match, deliver

Fastlane bao gồm một bộ công cụ chuyên dụng, mỗi công cụ giải quyết một tác vụ tự động hóa di động cụ thể. Các công cụ được chạy dưới dạng actions trong lanes hoặc trực tiếp từ dòng lệnh. Hãy xem xét bốn công cụ chính bao phủ các nhu cầu CI/CD cơ bản cho iOS và Android.

Scan đơn giản hóa việc chạy kiểm thử Xcode, tự động chọn trình mô phỏng phù hợp và định dạng báo cáo. Gym build ứng dụng với các cờ biên dịch tối ưu và hỗ trợ exportOptions.plist cho các loại build khác nhau (development, adhoc, appstore). Deliver cho phép tải lên không chỉ tập tin nhị phân mà còn cả ảnh chụp màn hình, mô tả, phiên bản và giá cả thông qua một tập tin siêu dữ liệu duy nhất.

Công cụ Match đáng được quan tâm đặc biệt — nó giải quyết vấn đề lưu trữ và đồng bộ chứng chỉ iOS trong nhóm. Match mã hóa và lưu trữ chứng chỉ và hồ sơ cấp quyền trong kho lưu trữ Git, và các nhà phát triển nhận được chúng tự động khi chạy fastlane match. Điều này loại bỏ việc cấu hình thủ công từng máy trạm làm việc.

Snapshot: tạo ảnh chụp màn hình

Snapshot là công cụ tự động tạo ảnh chụp màn hình của ứng dụng di động trên các thiết bị và ngôn ngữ khác nhau. Snapshot chạy kiểm thử UI trên trình mô phỏng iOS, chụp màn hình ở mỗi bước kiểm thử. Kết quả được lưu trong thư mục fastlane/screenshots và có thể được tải lên App Store Connect qua deliver.

Đối với Android, screengrab thực hiện chức năng tương tự trên trình giả lập Android. Cả hai công cụ đều hỗ trợ bản địa hóa — ảnh chụp màn hình được tạo cho từng ngôn ngữ, giúp đơn giản hóa việc chuẩn bị tài liệu cho xuất bản trên các cửa hàng ứng dụng đa ngôn ngữ.

Cấu hình Fastlane cho ứng dụng iOS

Đối với dự án iOS, Fastlane được cấu hình qua Gemfile (cài đặt gem fastlane) và Fastfile trong thư mục fastlane. Cấu hình ban đầu được thực hiện bằng lệnh fastlane init, lệnh này tạo cấu trúc thư mục cơ bản, yêu cầu dữ liệu App Store Connect và tạo mẫu Fastfile với các lanes chính.

Lệnh chính cho iOS là fastlane match, phải được chạy đầu tiên để lấy chứng chỉ và hồ sơ cấp quyền. Sau khi ký mã thành công, Fastlane có thể build ứng dụng (gym), chạy kiểm thử (scan) và tải tập tin nhị phân lên (pilot hoặc deliver).

# Fastfile cho ứng dụng iOS
default_platform(:ios)

lane :build do
  cocoapods
  scan(scheme: 'App', devices: ['iPhone 15'])
  gym(scheme: 'App', export_method: 'app-store')
end

lane :deploy do
  match(type: 'appstore')
  build
  pilot(skip_waiting_for_build_processing: true)
  slack(message: 'Phiên bản mới đã được tải lên TestFlight')
end

Để làm việc với TestFlight, hãy sử dụng action pilot — nó tải IPA lên và quản lý người kiểm thử. Fastlane hỗ trợ upload_to_testflight (đồng nghĩa với pilot) và tự động xử lý thời gian chờ xử lý build của Apple, có thể mất từ 5 đến 30 phút.

Cấu hình Fastlane cho ứng dụng Android

Đối với dự án Android, Fastlane được cấu hình tương tự, nhưng thay vì công cụ Xcode, Gradle và Android SDK được sử dụng. Fastlane cho Android hỗ trợ build APK và AAB, ký mã qua apksigner hoặc jarsigner, chạy kiểm thử công cụ và tải lên Google Play Console qua action Supply.

Sự khác biệt chính là build Android không yêu cầu quản lý chứng chỉ qua match (ký mã Android được quản lý qua Keystore, lưu trữ riêng). Fastlane cho Android sử dụng action gradle để chạy bất kỳ tác vụ Gradle nào và action supply để làm việc với Google Play.

# Fastfile cho ứng dụng Android
default_platform(:android)

lane :build do
  gradle(task: 'clean assembleRelease')
  gradle(task: 'testReleaseUnitTest')
end

lane :deploy do
  build
  supply(
    track: 'internal',
    aab: 'app/build/outputs/bundle/release/app-release.aab'
  )
end

Để làm việc với Google Play Console, cần có tài khoản dịch vụ Google Cloud có quyền truy cập API Google Play. Fastlane chấp nhận khóa JSON của tài khoản dịch vụ qua biến môi trường SUPPLY_JSON_KEY hoặc tham số json_key trong action supply. Track xuất bản có thể là internal, alpha, beta hoặc production.

Tích hợp Fastlane với hệ thống CI/CD

Fastlane có thể tích hợp với bất kỳ hệ thống CI/CD nào có thể chạy tập lệnh Ruby: Jenkins, Travis CI, GitHub Actions, GitLab CI, Bitrise và CircleCI. Việc tích hợp chỉ đơn giản là cài đặt gem fastlane và chạy lệnh fastlane [lane_name] trong giai đoạn script của pipeline.

Đối với CI/CD, việc cấu hình biến môi trường để lưu trữ dữ liệu nhạy cảm là rất quan trọng: MATCH_PASSWORD (mật khẩu mã hóa chứng chỉ), FASTLANE_USER (Apple ID), FASTLANE_PASSWORD (mật khẩu Apple ID). Trong Travis CI, các biến được mã hóa qua travis encrypt; trong GitHub Actions, qua Secrets của kho lưu trữ.

Phương pháp được khuyến nghị là sử dụng fastlane match trong CI/CD với cờ readonly để tránh các thay đổi vô tình trong kho lưu trữ chứng chỉ. Đối với Android, hãy sử dụng Keystore được mã hóa Base64 và lưu trữ trong biến môi trường, được giải mã và lưu vào tập tin tạm thời ở giai đoạn before_install.

Fastlane Match: quản lý chứng chỉ và hồ sơ

Fastlane Match là công cụ tự động hóa quản lý chứng chỉ iOS và hồ sơ cấp quyền, một trong những tính năng giá trị nhất của Fastlane cho các nhóm. Match tạo một kho lưu trữ Git được mã hóa (hoặc sử dụng kho có sẵn) để lưu trữ tất cả chứng chỉ và hồ sơ, đồng bộ hóa chúng giữa các nhà phát triển và máy chủ CI/CD.

Match hỗ trợ năm loại hồ sơ: development, adhoc, appstore, enterprise và developer_id. Mỗi loại được lưu trữ trong một thư mục riêng trong kho lưu trữ. Lệnh fastlane match development cài đặt chứng chỉ phát triển lên máy cục bộ, trong khi fastlane match appstore cài đặt hồ sơ App Store cho build CI.

# Sử dụng Match trong Fastfile
lane :setup_signing do
  match(
    type: 'appstore',
    readonly: true,
    git_branch: 'main'
  )
end

lane :update_profiles do
  match(
    type: 'development',
    force: true,
    app_identifier: ['com.example.app', 'com.example.app.watchkitapp']
  )
end

Bảo mật của Match được đảm bảo bằng mã hóa tất cả các tập tin trước khi commit vào Git. Mật khẩu mã hóa được đặt qua biến môi trường MATCH_PASSWORD và phải giống nhau cho tất cả thành viên trong nhóm. Match sử dụng OpenSSL để mã hóa và không lưu trữ mật khẩu dưới dạng văn bản thuần túy trong kho lưu trữ.