Chuyển đổi AAB sang APK trực tuyến: Công cụ này thực sự làm được gì
Android App Bundle (.aab) là định dạng mà Google Play yêu cầu nhà phát triển tải lên nhưng đây không phải là định dạng bạn có thể cài đặt trên điện thoại. Nếu bạn có tệp .aab từ máy chủ bản dựng, đường dẫn CI hoặc đồng nghiệp, trước tiên bạn cần biến tệp đó thành tệp .apk có thể cài đặt. Trang này cung cấp cho bạn hai thứ cho công việc đó: một Trình tạo lệnh AAB sang APK tương tác viết lệnh Bundletool chính xác cho hệ điều hành của bạn và một Trình khám phá tệp AAB mở gói trong trình duyệt của bạn để bạn có thể xem nội dung bên trong trước khi chuyển đổi nó.
Bản thân quá trình chuyển đổi chạy qua bundletool chính thức của Google, đây là một chương trình Java. Vì Bundletool cần thời gian chạy Java và quyền truy cập vào kho khóa của bạn nên bước xây dựng thực tế diễn ra trên máy của chính bạn chứ không phải trên máy chủ của chúng tôi. Tệp .aab của bạn không bao giờ được tải lên bất cứ đâu. Trình xây dựng chỉ cần loại bỏ phỏng đoán để bạn có thể sao chép lệnh chính xác, sẵn sàng chạy thay vì ghi nhớ tên cờ.
AAB vs APK: Tại sao bạn không thể đổi tên tệp
Rất nhiều người tìm kiếm cách thay đổi AAB thành APK bằng cách đổi tên tiện ích mở rộng và nó không bao giờ hoạt động. .apk là một gói độc lập, duy nhất mà Android có thể cài đặt trực tiếp. .aab là một vùng chứa xuất bản: nó chứa mã đã biên dịch và tài nguyên của bạn được chia thành các mô-đun, đồng thời nó yêu cầu Google Play hoặc Bundletool tạo các APK cuối cùng được tối ưu hóa cho thiết bị từ đó. Việc đổi tên tệp không giải nén các mô-đun đó hoặc ký bất kỳ thứ gì, vì vậy Android từ chối cài đặt nó. Cách đáng tin cậy duy nhất để chuyển đổi Gói ứng dụng Android thành APK là để Bundletool xây dựng bộ APK cho bạn.
Cách chuyển đổi AAB sang APK trên Windows, Mac và Linux
Các bước đều giống nhau trên mọi nền tảng và chỉ có kiểu đường dẫn tệp thay đổi, đó là lý do tại sao trình tạo lệnh ở trên có bộ chuyển đổi Windows, macOS và Linux. Đây là toàn bộ dòng chảy từ đầu đến cuối:
- Cài đặt Java JDK 8 hoặc mới hơn. Chạy java -version trong một thiết bị đầu cuối để xác nhận Java có trên PATH của bạn.
- Tải xuống góitool. Nhận bundletool-all.jar mới nhất từ trang phát hành GitHub chính thức của Google.
- Xây dựng bộ APK. Trỏ Bundletool vào gói của bạn và để nó tạo ra kho lưu trữ .apks: java -jar bundletool-all.jar build-apks --bundle=app.aab --output=app.apks --mode=universal
- Mở kho lưu trữ .apks. Nó chỉ là một tệp ZIP, vì vậy hãy giải nén nó và bạn sẽ tìm thấy universal.apk bên trong.
- Cài đặt trên thiết bị của bạn. Sao chép APK vào điện thoại của bạn và tải nó xuống hoặc sử dụng bundletool install-apks với thiết bị được kết nối qua USB.
APK phổ quát và APK chia nhỏ: Bạn nên xây dựng cái nào?
Nếu bạn muốn một tệp cài đặt trên bất kỳ điện thoại nào, hãy sử dụng --mode=universal. Điều này xây dựng một APK phổ quát từ AAB của bạn duy nhất kết hợp mọi kiến trúc CPU, mật độ màn hình và ngôn ngữ vào một gói. Nó lớn hơn nhưng là tùy chọn đơn giản nhất để thử nghiệm, lưu trữ hoặc chia sẻ bản dựng bên ngoài Cửa hàng Play. Nếu bạn tắt chế độ này, thay vào đó, Bundletool sẽ tạo các APK phân tách được cắt bớt cho một thiết bị cụ thể để chúng tải xuống nhỏ hơn nhưng bạn phải cài đặt bộ phù hợp với nhau. Đối với hầu hết những người chỉ cần chuyển đổi .aab để cài đặt nhanh, APK phổ quát là lựa chọn phù hợp.
Ký APK bạn nhận được từ AAB
Android sẽ không cài đặt APK trừ khi nó được ký. Để thử nghiệm, Bundletool có thể tự động ký bằng khóa gỡ lỗi, đây chính xác là những gì tùy chọn "Sử dụng kho khóa gỡ lỗi" trong trình tạo thực hiện. Nếu bạn đang chuẩn bị bản phát hành, chẳng hạn như để phân phối trên trang web của riêng bạn, hãy ký nó với kho khóa của riêng bạn bằng cách điền vào đường dẫn kho khóa, mật khẩu kho khóa, bí danh khóa và các trường mật khẩu chính. Sau đó, trình tạo sẽ thêm các cờ --ks, --ks-pass, --ks-key-alias và --key-pass để APK bạn nhận được mang chữ ký sản xuất thực của bạn thay vì chữ ký gỡ lỗi dùng một lần.
Các lỗi Bundletool thường gặp và cách khắc phục
Hai vấn đề cứ lặp đi lặp lại. Thông báo "bundletool: không tìm thấy lệnh" có nghĩa là bạn đã cố chạy Bundletool như thể đó là một lệnh tích hợp. Nó là một tệp JAR, vì vậy bạn luôn gọi nó bằng java -jar bundletool-all.jar. Lỗi "Không có khóa/chứng chỉ" có nghĩa là thiếu chi tiết ký: thêm --mode=universal cho bản dựng thử nghiệm chưa được ký hoặc cung cấp cờ kho khóa của bạn như mô tả ở trên. Tab Khắc phục sự cố ở phía trên trang bao gồm nhiều nội dung trong số này hơn và AAB Explorer cho phép bạn xác nhận gói của mình thực sự chứa các mô-đun mà bạn mong đợi trước khi dành thời gian gỡ lỗi một lệnh.
Khi nào bạn thực sự cần chuyển đổi AAB?
Các lý do thông thường là thử nghiệm bản phát hành trên thiết bị thực trước khi bạn xuất bản, giao bản dựng cho người thử nghiệm không sử dụng Google Play, giữ bản sao có thể cài đặt của ứng dụng của riêng bạn để lưu vào hồ sơ hoặc chạy QA trên phần cứng mà thử nghiệm nội bộ của Cửa hàng Play không đạt được. Dù lý do là gì, chỉ chuyển đổi các gói ứng dụng mà bạn có quyền sử dụng, chẳng hạn như các bản dựng của riêng bạn hoặc các gói mà bạn có quyền rõ ràng để làm việc.