Bạn có thể phân phối bản dựng cho người kiểm thử bằng cách sử dụng fastlane, một nền tảng nguồn mở tự động tạo và phát hành ứng dụng iOS và Android. Phương thức này tuân theo các hướng dẫn đơn giản được xác định trong Fastfile
. Sau khi thiết lập
fastlane và Fastfile
, bạn có thể tích hợp App Distribution với cấu hình
fastlane.
Bước 1. Thiết lập fastlane
Để thêm App Distribution vào cấu hình fastlane, hãy chạy lệnh sau từ thư mục gốc của dự án iOS:
fastlane add_plugin firebase_app_distribution
Nếu lệnh nhắc bạn chọn một tuỳ chọn, hãy chọn
Option 3: RubyGems.org
.
Bước 2. Xác thực bằng Firebase
Trước khi có thể sử dụng trình bổ trợ fastlane, trước tiên, bạn phải xác thực bằng dự án Firebase theo một trong những cách sau. Theo mặc định, trình bổ trợ fastlane sẽ tìm thông tin xác thực từ CLI Firebase nếu không sử dụng phương thức xác thực nào khác.
Sử dụng thông tin xác thực tài khoản dịch vụ Firebase
Việc xác thực bằng tài khoản dịch vụ cho phép bạn linh hoạt sử dụng trình bổ trợ với hệ thống tích hợp liên tục (CI). Có hai cách để cung cấp thông tin xác thực tài khoản dịch vụ:
- Truyền tệp khoá tài khoản dịch vụ của bạn đến thao tác
firebase_app_distribution
. Bạn có thể thấy phương thức này thuận tiện nếu đã có tệp khoá tài khoản dịch vụ trong môi trường xây dựng. - Đặt biến môi trường
GOOGLE_APPLICATION_CREDENTIALS
để trỏ đến tệp khoá tài khoản dịch vụ. Bạn nên sử dụng phương thức này nếu đã định cấu hình Thông tin xác thực mặc định của ứng dụng (ADC) cho một dịch vụ khác của Google (ví dụ: Google Cloud).
- Trên bảng điều khiển Google Cloud, hãy chọn dự án của bạn và tạo một tài khoản dịch vụ mới.
- Thêm vai trò Quản trị viên Firebase App Distribution.
- Tạo khoá json riêng tư và di chuyển khoá đó đến một vị trí mà môi trường xây dựng của bạn có thể truy cập. Hãy nhớ lưu tệp này ở nơi an toàn vì tệp này cấp quyền truy cập của quản trị viên vào App Distribution trong dự án Firebase của bạn.
- Bỏ qua bước này nếu bạn đã tạo ứng dụng sau ngày 20 tháng 9 năm 2019: Trong Google API Console, hãy bật Firebase App Distribution API. Khi được nhắc, hãy chọn dự án có cùng tên với dự án Firebase của bạn.
Cung cấp hoặc tìm thông tin đăng nhập vào tài khoản dịch vụ:
- Để truyền khoá tài khoản dịch vụ của bạn đến thao tác
firebase_app_distribution
của làn, hãy đặt tham sốservice_credentials_file
bằng đường dẫn đến tệp JSON khoá riêng tư Để tìm thông tin xác thực bằng ADC, hãy đặt biến môi trường
GOOGLE_APPLICATION_CREDENTIALS
thành đường dẫn cho tệp JSON khoá riêng tư. Ví dụ:export GOOGLE_APPLICATION_CREDENTIALS=/absolute/path/to/credentials/file.json
Để biết thêm thông tin về cách xác thực bằng ADC, hãy đọc bài viết Cung cấp thông tin xác thực cho ứng dụng.
- Để truyền khoá tài khoản dịch vụ của bạn đến thao tác
Đăng nhập bằng CLI Firebase
Hãy xem phần Đăng nhập bằng CLI Firebase để biết hướng dẫn về cách xác thực dự án.
Bước 3. Thiết lập Fastfile và phân phối ứng dụng
- Trong làn
./fastlane/Fastfile
, hãy thêm một khốifirebase_app_distribution
. Sử dụng các tham số sau để định cấu hình quá trình phân phối:Thông số firebase_app_distribution app
Chỉ bắt buộc nếu ứng dụng của bạn không chứa tệp cấu hình Firebase (
GoogleService-Info.plist
): Mã ứng dụng Firebase của ứng dụng. Bạn có thể tìm thấy Mã ứng dụng trong bảng điều khiển Firebase, trên trang Cài đặt chung.app: "1:1234567890:ios:0a1b2c3d4e5f67890"
googleservice_info_plist_path
Đường dẫn đến tệp
GoogleService-Info.plist
, tương ứng với đường dẫn sản phẩm đã lưu trữ. Theo mặc định, giá trị này được đặt thànhGoogleService-Info.plist
.Tệp này được dùng để lấy Mã ứng dụng Firebase của ứng dụng nếu bạn không chỉ định tham số
app
.firebase_cli_token
Mã thông báo làm mới được in khi bạn xác thực môi trường CI bằng CLI Firebase (hãy đọc bài viết Sử dụng CLI với các hệ thống CI để biết thêm thông tin).
service_credentials_file
Đường dẫn đến tệp json của tài khoản dịch vụ Google. Hãy xem phần trên để biết cách xác thực bằng thông tin xác thực tài khoản dịch vụ.
ipa_path
Thay thế
apk_path
(không dùng nữa). Đường dẫn tuyệt đối đến tệp IPA mà bạn muốn tải lên. Nếu không được chỉ định, fastlane sẽ xác định vị trí của tệp từ làn đường mà tệp được tạo.release_notes
release_notes_file
Ghi chú phát hành cho bản dựng này.
Bạn có thể chỉ định ghi chú phát hành trực tiếp:
release_notes: "Text of release notes"
Hoặc chỉ định đường dẫn đến tệp văn bản thuần tuý:
release_notes_file: "/path/to/release-notes.txt"
testers
testers_file
Địa chỉ email của người kiểm thử mà bạn muốn mời.
Bạn có thể chỉ định người kiểm thử dưới dạng danh sách địa chỉ email được phân tách bằng dấu phẩy:
testers: "ali@example.com, bri@example.com, cal@example.com"
Hoặc bạn có thể chỉ định đường dẫn đến một tệp văn bản thuần tuý chứa danh sách địa chỉ email được phân tách bằng dấu phẩy:
testers_file: "/path/to/testers.txt"
groups
groups_file
Các nhóm người kiểm thử mà bạn muốn mời (tham khảo phần Quản lý người kiểm thử). Các nhóm được chỉ định bằng
bí danh nhóm mà bạn có thể tra cứu trong bảng điều khiển Firebase.Bạn có thể chỉ định các nhóm dưới dạng danh sách được phân tách bằng dấu phẩy:
groups: "qa-team, trusted-testers"
Hoặc bạn có thể chỉ định đường dẫn đến một tệp văn bản thuần tuý chứa danh sách tên nhóm được phân tách bằng dấu phẩy:
groups_file: "/path/to/groups.txt"
test_devices
test_devices_file
Các loại phân phối sau đây là một phần của tính năng thử nghiệm Trình kiểm thử tự động.
Các thiết bị kiểm thử mà bạn muốn phân phối bản dựng (tham khảo phần Kiểm thử tự động).
Bạn có thể chỉ định thiết bị kiểm thử dưới dạng danh sách thiết bị kiểm thử được phân tách bằng dấu chấm phẩy:
test_devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"
Hoặc bạn có thể chỉ định đường dẫn đến một tệp văn bản thuần tuý chứa danh sách thiết bị kiểm thử được phân tách bằng dấu chấm phẩy:
test_devices_file: "/path/to/test-devices.txt"
test_username
Tên người dùng để đăng nhập tự động được sử dụng trong quá trình kiểm thử tự động.
test_password
test_password_file
Mật khẩu đăng nhập tự động được dùng trong quá trình kiểm thử tự động.
Ngoài ra, bạn có thể chỉ định đường dẫn đến tệp văn bản thuần tuý chứa mật khẩu:
test_password_file: "/path/to/test-password.txt"
test_username_resource
Tên tài nguyên cho trường tên người dùng để đăng nhập tự động được sử dụng trong quá trình kiểm thử tự động.
test_password_resource
Tên tài nguyên cho trường mật khẩu để đăng nhập tự động được sử dụng trong quá trình kiểm thử tự động.
test_non_blocking
Chạy kiểm thử tự động không đồng bộ. Truy cập vào bảng điều khiển của Firebase để xem kết quả kiểm thử tự động.
debug
Cờ boolean. Bạn có thể đặt giá trị này thành
true
để in kết quả gỡ lỗi chi tiết.
Ví dụ:
platform :ios do desc "My awesome app" lane :distribute do build_ios_app(...) # build_ios_app is a built-in fastlane action. release = firebase_app_distribution( app: "1:123456789:ios:abcd1234", testers: "tester1@company.com, tester2@company.com", release_notes: "Lots of amazing new features to test out!" ) end end
Để cung cấp bản dựng cho người kiểm thử, hãy chạy làn của bạn:
fastlane <lane>
Giá trị trả về của thao tác này là một hàm băm đại diện cho bản phát hành đã tải lên.
Bạn cũng có thể sử dụng lane_context[SharedValues::FIREBASE_APP_DISTRO_RELEASE]
để tạo hàm băm này.
Để biết thêm thông tin về các trường có sẵn trong hàm băm này, hãy xem tài liệu về API REST.
Trình bổ trợ fastlane sẽ xuất ra các đường liên kết sau đây sau khi tải bản phát hành lên. Các đường liên kết này giúp bạn quản lý tệp nhị phân và đảm bảo rằng người kiểm thử cũng như các nhà phát triển khác có bản phát hành phù hợp:
- Đường liên kết đến bảng điều khiển Firebase hiển thị một bản phát hành. Bạn có thể chia sẻ đường liên kết này với các nhà phát triển khác trong tổ chức của mình.
- Đường liên kết đến bản phát hành trong trải nghiệm của người kiểm thử (đoạn trích web iOS) cho phép người kiểm thử xem ghi chú phát hành và cài đặt ứng dụng trên thiết bị của họ. Người kiểm thử cần có quyền truy cập vào bản phát hành để sử dụng đường liên kết.
- Đường liên kết đã ký tải trực tiếp và cài đặt tệp nhị phân của ứng dụng (tệp IPA). Đường liên kết này sẽ hết hạn sau một giờ.
Sau khi bạn phân phối bản dựng, bản dựng đó sẽ có trong trang tổng quan App Distribution của bảng điều khiển Firebase trong 150 ngày. Khi bản dựng sắp hết hạn 30 ngày, thông báo hết hạn sẽ xuất hiện trong bảng điều khiển và trong danh sách bản dựng của người kiểm thử trên thiết bị kiểm thử của họ.
Những người kiểm thử chưa từng được mời thử nghiệm ứng dụng sẽ nhận được lời mời qua email để bắt đầu. Người kiểm thử hiện tại sẽ nhận được thông báo qua email rằng bản dựng mới đã sẵn sàng để kiểm thử. Để tìm hiểu cách cài đặt ứng dụng kiểm thử, hãy xem phần Thiết lập làm người kiểm thử. Bạn có thể theo dõi trạng thái của từng người kiểm thử để xác định xem họ có chấp nhận lời mời và tải ứng dụng xuống trong bảng điều khiển Firebase hay không.
(Không bắt buộc) Để tự động tăng số bản dựng mỗi khi bạn tạo một bản phát hành mới trong App Distribution, bạn có thể sử dụng thao tác firebase_app_distribution_get_latest_release
và thao tác increment_build_number
.
Mã sau đây cung cấp ví dụ về cách tự động tăng số bản dựng:
lane :increment_version do
latest_release = firebase_app_distribution_get_latest_release(
app: "<your Firebase app ID>"
)
increment_build_number({ build_number: latest_release[:buildVersion].to_i + 1 })
end
Để tìm hiểu thêm về tính năng trình bổ trợ fastlane này, hãy xem phần Nhận thông tin về bản phát hành mới nhất của ứng dụng.
Bước 4 (Không bắt buộc). Quản lý người thử nghiệm cho bản phát hành
Bạn có thể thêm và xoá người kiểm thử khỏi dự án hoặc nhóm bằng tệp Fastfile
hoặc bằng cách chạy trực tiếp các thao tác fastlane. Việc chạy hành động trực tiếp sẽ ghi đè các giá trị được đặt trong Fastfile
.
Sau khi thêm người kiểm thử vào dự án Firebase, bạn có thể thêm họ vào từng bản phát hành. Những người kiểm thử bị xoá khỏi dự án Firebase sẽ không còn quyền truy cập vào các bản phát hành trong dự án của bạn, nhưng họ có thể giữ lại quyền truy cập vào các bản phát hành trong một khoảng thời gian.
Nếu có một số lượng lớn người kiểm thử, bạn nên cân nhắc sử dụng nhóm.
Sử dụng Fastfile
# Use lanes to add or remove testers from a project. lane(:add_testers) do firebase_app_distribution_add_testers( emails: "foo@google.com,bar@google.com" # or file: "/path/to/testers.txt" group_alias: "qa-team" # (Optional) add testers to this group ) end lane(:remove_testers) do firebase_app_distribution_remove_testers( emails: "foo@google.com,bar@google.com" # or file: "/path/to/testers.txt" group_alias: "qa-team" # (Optional) remove testers from this group only ) end
# Add or remove testers with the terminal
$ fastlane add_testers
$ fastlane remove_testers
Chạy các thao tác fastlane
fastlane run firebase_app_distribution_create_group display_name:"QA Team" alias:"qa-team"
fastlane run firebase_app_distribution_add_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_remove_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_delete_group alias:"qa-team"
Bạn cũng có thể chỉ định người kiểm thử bằng --file="/path/to/testers.txt
thay vì --emails
.
Tác vụ firebase_app_distribution_add_testers
và
firebase_app_distribution_remove_testers
cũng chấp nhận các đối số
sau:
project_name
: Số dự án Firebase của bạn.group_alias
(không bắt buộc): Nếu được chỉ định, người kiểm thử sẽ được thêm vào (hoặc xoá khỏi) nhóm đã chỉ định.service_credentials_file
: Đường dẫn đến tệp thông tin xác thực dịch vụ của Google.firebase_cli_token
: Mã thông báo xác thực cho CLI Firebase.
service_credentials_file
và firebase_cli_token
là cùng một đối số mà thao tác tải lên sử dụng.
Bước 5 (Không bắt buộc). Xem thông tin về bản phát hành mới nhất của ứng dụng
Bạn có thể sử dụng thao tác firebase_app_distribution_get_latest_release
để tìm nạp thông tin về bản phát hành mới nhất của ứng dụng trong tính năng Phân phối ứng dụng, bao gồm thông tin về phiên bản ứng dụng, ghi chú phát hành và thời gian tạo. Các trường hợp sử dụng bao gồm việc tự động tăng phiên bản và chuyển các ghi chú phát hành từ bản phát hành trước.
Giá trị trả về của thao tác này là một hàm băm đại diện cho bản phát hành mới nhất.
Bạn cũng có thể sử dụng lane_context[SharedValues::FIREBASE_APP_DISTRO_LATEST_RELEASE]
để tạo hàm băm này.
Để biết thêm thông tin về các trường có sẵn trong hàm băm này, hãy xem tài liệu về API REST.
Thông số
Tham số firebase_app_distribution_get_latest_release | |
---|---|
app
|
Chỉ bắt buộc nếu ứng dụng của bạn không chứa tệp cấu hình Firebase ( app: "1:1234567890:ios:0a1b2c3d4e5f67890" |
googleservice_info_plist_path
|
Đường dẫn đến tệp
Tệp này được dùng để lấy Mã ứng dụng Firebase của ứng dụng nếu bạn không chỉ định tham số |
firebase_cli_token
|
Mã thông báo làm mới được in khi bạn xác thực môi trường CI bằng CLI Firebase (hãy đọc bài viết Sử dụng CLI với các hệ thống CI để biết thêm thông tin). |
service_credentials_file
|
Đường dẫn đến tệp json của tài khoản dịch vụ Google. Hãy xem tài liệu trước đó để biết cách xác thực bằng thông tin xác thực tài khoản dịch vụ. |
service_credentials_json_data
|
Nội dung tệp json của tài khoản dịch vụ của Google. Hãy xem tài liệu trước đó để biết cách xác thực bằng thông tin xác thực tài khoản dịch vụ. |
debug
|
Cờ boolean. Bạn có thể đặt giá trị này thành |
Các bước tiếp theo
Để đăng ký thêm thiết bị theo cách thủ công hoặc theo phương thức lập trình, hãy xem phần Đăng ký thêm thiết bị iOS.
Tìm hiểu các phương pháp hay nhất để phân phối ứng dụng Apple cho người kiểm thử QA bằng CI/CD và fastlane.