Tạo nhiều APK cho các kích thước màn hình khác nhau

Nếu bạn phát hành ứng dụng lên Google Play thì bạn nên tạo và tải một Android App Bundle lên. Khi bạn làm như vậy, Google Play sẽ tự động tạo và phân phát các tệp APK được tối ưu hoá cho cấu hình thiết bị của mỗi người dùng, vì vậy, họ chỉ tải mã và tài nguyên mà họ cần để chạy ứng dụng. Việc phát hành nhiều tệp APK rất hữu ích nếu bạn hiện chưa phát hành ứng dụng lên Google Play, nhưng bạn phải tự xây dựng, ký và quản lý từng tệp APK.

Khi phát triển ứng dụng Android để tận dụng nhiều APK trên Google Play, bạn cần áp dụng một số phương pháp hay ngay từ đầu để tránh gặp phải những vấn đề không cần thiết trong quá trình phát triển. Bài học này hướng dẫn bạn cách tạo nhiều APK của ứng dụng, mỗi APK dành cho một loại kích thước màn hình khác nhau. Bạn cũng sẽ có được một số công cụ cần thiết để duy trì cơ sở mã APK nhiều nhất có thể.

Xác nhận rằng bạn cần nhiều tệp APK

Khi cố gắng tạo một ứng dụng hoạt động trên nhiều kích thước thiết bị Android, bạn muốn ứng dụng của mình tận dụng tất cả không gian có sẵn trên các thiết bị lớn hơn mà không làm giảm khả năng tương thích hoặc khả năng hữu dụng trên các màn hình nhỏ hơn. Ban đầu, có vẻ như việc hỗ trợ nhiều APK là giải pháp tốt nhất, nhưng thường thì không phải vậy. Phần Sử dụng một tệp APK trong hướng dẫn dành cho nhà phát triển về nhiều tệp APK có một số thông tin hữu ích về cách thực hiện việc này bằng một tệp APK, bao gồm cả việc sử dụng thư viện hỗ trợ của chúng tôi. Bạn cũng nên đọc hướng dẫn về cách hỗ trợ nhiều màn hình. Thậm chí, bạn có thể tải một thư viện hỗ trợ xuống bằng SDK Android để sử dụng các mảnh trên các thiết bị chạy trước Honeycomb (giúp hỗ trợ nhiều màn hình trong một tệp APK dễ dàng hơn nhiều).

Nếu bạn có thể quản lý được, việc giới hạn ứng dụng của bạn trong một tệp APK sẽ có một số lợi thế, bao gồm:

  • Dễ dàng phát hành và kiểm thử hơn
  • Chỉ có một cơ sở mã để duy trì
  • Ứng dụng của bạn có thể thích ứng với các thay đổi về cấu hình thiết bị
  • Khôi phục ứng dụng trên nhiều thiết bị
  • Bạn không phải lo lắng về lựa chọn ưu tiên của thị trường, hành vi "nâng cấp" từ APK này sang APK khác hoặc APK nào phù hợp với loại thiết bị nào

Phần còn lại của bài học này giả định rằng bạn đã nghiên cứu chủ đề, chăm chỉ tiếp thu tài liệu trong các tài nguyên được liên kết và xác định rằng nhiều APK là đường dẫn phù hợp cho ứng dụng của bạn.

Lập biểu đồ các yêu cầu

Bắt đầu bằng cách tạo một biểu đồ đơn giản để nhanh chóng xác định số lượng APK bạn cần và(các) kích thước màn hình mà mỗi APK bao gồm. May mắn thay, bạn có thể dễ dàng lập biểu đồ các yêu cầu của mình một cách nhanh chóng và dễ dàng, đồng thời có tài liệu tham khảo sau này. Bắt đầu với một hàng ô đại diện cho nhiều kích thước màn hình có trên nền tảng Android.

nhỏ bình thường lớn xlarge

Bây giờ, bạn chỉ cần tô màu trong biểu đồ sao cho mỗi màu đại diện cho một APK. Dưới đây là một ví dụ về cách bạn có thể áp dụng từng tệp APK cho một phạm vi kích thước màn hình nhất định.

nhỏ bình thường lớn xlarge

Tuỳ thuộc vào nhu cầu, bạn cũng có thể có hai tệp APK, "nhỏ và mọi thứ khác" hoặc "lớn và mọi thứ khác". Việc tô màu trong biểu đồ cũng giúp việc giao tiếp nội bộ nhóm trở nên dễ dàng hơn. Giờ đây, bạn chỉ cần gọi mỗi APK là "xanh dương", "xanh lục" hoặc "đỏ", bất kể APK đó bao gồm bao nhiêu loại màn hình.

Đặt tất cả mã và tài nguyên phổ biến vào một dự án thư viện

Cho dù bạn đang sửa đổi một ứng dụng Android hiện có hay bắt đầu một ứng dụng từ đầu, đây là điều đầu tiên bạn nên làm với cơ sở mã và quan trọng nhất. Mọi nội dung đi vào dự án thư viện chỉ cần được cập nhật một lần (hãy nghĩ đến các chuỗi được bản địa hoá theo ngôn ngữ, giao diện màu sắc, lỗi được khắc phục trong mã dùng chung), giúp cải thiện thời gian phát triển và giảm khả năng mắc lỗi mà bạn có thể dễ dàng tránh được.

Lưu ý: Mặc dù thông tin chi tiết về cách triển khai để tạo và đưa các dự án thư viện vào nằm ngoài phạm vi của bài học này, nhưng bạn có thể nắm bắt nhanh bằng cách đọc bài viết Tạo thư viện Android.

Nếu bạn đang chuyển đổi một ứng dụng hiện có để sử dụng tính năng hỗ trợ nhiều APK, hãy tìm kiếm trong cơ sở mã của bạn mọi tệp chuỗi đã bản địa hoá, danh sách giá trị, màu giao diện, biểu tượng trình đơn và bố cục sẽ không thay đổi trên các APK, đồng thời đưa tất cả vào dự án thư viện. Mã không thay đổi nhiều cũng nên được đưa vào dự án thư viện. Bạn có thể sẽ thấy mình mở rộng các lớp này để thêm một hoặc hai phương thức từ APK sang APK.

Mặt khác, nếu bạn đang tạo ứng dụng từ đầu, hãy cố gắng viết mã trong dự án thư viện trước tiên, sau đó chỉ di chuyển mã đó xuống một tệp APK riêng lẻ nếu cần. Việc này sẽ dễ quản lý hơn nhiều về lâu dài so với việc thêm blob vào một thư mục, rồi thêm vào một thư mục khác, rồi thêm vào một thư mục khác, sau đó nhiều tháng sau mới tìm cách xem liệu blob này có thể được chuyển lên phần thư viện mà không làm hỏng bất kỳ nội dung nào không.

Tạo dự án APK mới

Bạn nên có một dự án Android riêng cho mỗi tệp APK mà bạn sắp phát hành. Để dễ dàng sắp xếp, hãy đặt dự án thư viện và tất cả dự án APK có liên quan trong cùng một thư mục mẹ. Ngoài ra, hãy nhớ rằng mỗi APK cần có cùng một tên gói, mặc dù các APK không nhất thiết phải dùng chung tên gói với thư viện. Nếu bạn có 3 tệp APK theo lược đồ mô tả ở trên, thư mục gốc của bạn có thể có dạng như sau:

alexlucas:~/code/multi-apks-root$ ls
foo-blue
foo-green
foo-lib
foo-red

Sau khi tạo các dự án, hãy thêm dự án thư viện làm tham chiếu cho từng dự án APK. Nếu có thể, hãy xác định Hoạt động bắt đầu trong dự án thư viện và mở rộng Hoạt động đó trong dự án APK. Việc xác định một hoạt động bắt đầu trong dự án thư viện sẽ giúp bạn có cơ hội đưa tất cả các hoạt động khởi chạy ứng dụng vào một nơi, nhờ đó, mỗi tệp APK riêng lẻ không phải triển khai lại các tác vụ "phổ quát" như khởi chạy Analytics, chạy quy trình kiểm tra giấy phép và mọi quy trình khởi chạy khác không thay đổi nhiều từ APK này sang APK khác.

Điều chỉnh tệp kê khai

Khi người dùng tải một ứng dụng sử dụng nhiều tệp APK xuống thông qua Google Play, tệp APK chính xác để sử dụng sẽ được chọn theo hai quy tắc đơn giản:

  • Tệp kê khai phải cho thấy rằng APK cụ thể đó đủ điều kiện
  • Trong số các tệp APK đủ điều kiện, tệp có số phiên bản cao nhất sẽ chiến thắng

Ví dụ: hãy lấy tập hợp nhiều tệp APK được mô tả ở trên và giả sử rằng mỗi tệp APK đã được thiết lập để hỗ trợ tất cả kích thước màn hình lớn hơn kích thước màn hình "mục tiêu" của tệp APK đó. Nếu xem riêng lẻ, phạm vi có thể có của mỗi APK sẽ có dạng như sau:

nhỏ bình thường lớn xlarge
nhỏ bình thường lớn xlarge
nhỏ bình thường lớn xlarge

Tuy nhiên, bằng cách sử dụng quy tắc "số phiên bản cao nhất sẽ thắng", nếu chúng ta đặt thuộc tính versionCode trong mỗi APK sao cho màu đỏ ≥ màu xanh lục ≥ màu xanh dương, thì biểu đồ sẽ thu gọn hiệu quả thành như sau:

nhỏ bình thường lớn xlarge

Bây giờ, hãy giả định thêm rằng APK màu đỏ có một số yêu cầu mà hai APK còn lại không có. Trang Bộ lọc trên Google Play trong Hướng dẫn dành cho nhà phát triển Android có toàn bộ danh sách các nguyên nhân có thể gây ra vấn đề. Ví dụ: giả sử màu đỏ yêu cầu máy ảnh mặt trước. Trên thực tế, toàn bộ điểm của APK màu đỏ là sử dụng không gian màn hình có sẵn để làm những việc giải trí bằng máy ảnh mặt trước đó. Nhưng hóa ra, không phải thiết bị xlarge nào cũng CÓ máy ảnh mặt trước! Thật kinh hoàng!

May mắn thay, nếu người dùng đang duyệt xem Google Play trên một thiết bị như vậy, Google Play sẽ xem tệp kê khai, thấy rằng Red liệt kê máy ảnh mặt trước là một yêu cầu và âm thầm bỏ qua yêu cầu đó, vì đã xác định rằng Red và thiết bị đó không phù hợp với nhau. Sau đó, bạn sẽ thấy rằng Màu xanh lục không chỉ tương thích với các thiết bị xlarge mà còn không quan tâm đến việc có máy ảnh trước hay không! Người dùng vẫn có thể tải ứng dụng xuống từ Google Play, vì mặc dù toàn bộ sự cố máy ảnh trước, nhưng vẫn có một tệp APK hỗ trợ kích thước màn hình cụ thể đó.

Để giữ tất cả tệp APK trên các "đường dẫn" riêng biệt, bạn cần có một lược đồ mã phiên bản tốt. Bạn có thể tìm thấy mã được đề xuất trong phần Mã phiên bản của hướng dẫn dành cho nhà phát triển. Vì tập hợp APK mẫu chỉ xử lý một trong 3 nhóm kích thước có thể có, nên bạn chỉ cần tách mỗi APK theo 1000 và tăng dần từ đó. Mã này có thể có dạng như sau:

Xanh dương: 1001, 1002, 1003, 1004...
Xanh lục: 2001, 2002, 2003, 2004...
Đỏ:3001, 3002, 3003, 3004...

Khi kết hợp tất cả những điều này, Tệp kê khai Android của bạn có thể sẽ có dạng như sau:

Màu lam:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    android:versionCode="1001" android:versionName="1.0" package="com.example.foo">
    <supports-screens android:smallScreens="true"
        android:normalScreens="true"
        android:largeScreens="true"
        android:xlargeScreens="true" />
    ...

Màu lục:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    android:versionCode="2001" android:versionName="1.0" package="com.example.foo">
    <supports-screens android:smallScreens="false"
        android:normalScreens="false"
        android:largeScreens="true"
        android:xlargeScreens="true" />
    ...

Màu đỏ:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    android:versionCode="3001" android:versionName="1.0" package="com.example.foo">
    <supports-screens android:smallScreens="false"
        android:normalScreens="false"
        android:largeScreens="false"
        android:xlargeScreens="true" />
    ...

Lưu ý rằng về mặt kỹ thuật, nhiều APK sẽ hoạt động với thẻ hỗ trợ màn hình hoặc thẻ màn hình tương thích. Bạn nên sử dụng thẻ Supports-screens và không nên sử dụng cả hai thẻ trong cùng một tệp kê khai. Điều này làm mọi thứ trở nên phức tạp một cách không cần thiết và làm tăng khả năng xảy ra lỗi. Ngoài ra, hãy lưu ý rằng thay vì tận dụng các giá trị mặc định (nhỏ và bình thường luôn là đúng theo mặc định), tệp kê khai sẽ đặt giá trị rõ ràng cho từng kích thước màn hình. Việc này có thể giúp bạn tránh được những rắc rối sau này. Ví dụ: tệp kê khai có SDK mục tiêu < 9 sẽ tự động đặt xlarge thành false, vì kích thước đó chưa tồn tại. Vì vậy, hãy nêu rõ!

Xem lại danh sách kiểm tra trước khi ra mắt

Trước khi tải lên Google Play, hãy kiểm tra kỹ các mục sau. Hãy nhớ rằng những điều này chỉ liên quan đến nhiều tệp APK và không thể hiện danh sách kiểm tra đầy đủ cho tất cả ứng dụng được tải lên Google Play.

  • Tất cả tệp APK phải có cùng tên gói
  • Tất cả tệp APK phải được ký bằng cùng một chứng chỉ
  • Đặt mọi kích thước màn hình mà bạn muốn APK hỗ trợ thành true trong tệp kê khai. Mọi kích thước màn hình mà bạn muốn tránh, hãy đặt thành false
  • Kiểm tra kỹ bộ lọc tệp kê khai để tìm thông tin xung đột (không ai sẽ thấy tệp APK chỉ hỗ trợ bánh cupcake trên màn hình XLARGE)
  • Tệp kê khai của mỗi tệp APK phải là duy nhất trên ít nhất một trong các màn hình, kết cấu OpenGL hoặc phiên bản nền tảng được hỗ trợ
  • Hãy thử kiểm thử từng tệp APK trên ít nhất một thiết bị. Ngoài ra, bạn có một trong những trình mô phỏng thiết bị có thể tuỳ chỉnh nhất trong ngành trên máy phát triển của mình. Chúc bạn thành công!

Bạn cũng nên kiểm tra tệp APK đã biên dịch trước khi đẩy ra thị trường để đảm bảo không có bất kỳ điều gì bất ngờ có thể ẩn ứng dụng của bạn trên Google Play. Việc này thực sự khá đơn giản khi sử dụng công cụ "aapt". Aapt (Công cụ đóng gói tài nguyên Android) là một phần của quy trình tạo bản dựng để tạo và đóng gói ứng dụng Android, đồng thời cũng là một công cụ rất hữu ích để kiểm tra các ứng dụng đó.

>aapt dump badging
package: name='com.example.hello' versionCode='1' versionName='1.0'
sdkVersion:'11'
uses-permission:'android.permission.SEND_SMS'
application-label:'Hello'
application-icon-120:'res/drawable-ldpi/icon.png'
application-icon-160:'res/drawable-mdpi/icon.png'
application-icon-240:'res/drawable-hdpi/icon.png'
application: label='Hello' icon='res/drawable-mdpi/icon.png'
launchable-activity: name='com.example.hello.HelloActivity'  label='Hello' icon=''
uses-feature:'android.hardware.telephony'
uses-feature:'android.hardware.touchscreen'
main
supports-screens: 'xlarge'
supports-any-density: 'true'
locales: '--_--'
densities: '120' '160' '240'

Khi kiểm tra đầu ra aapt, hãy nhớ kiểm tra để đảm bảo bạn không có các giá trị xung đột cho màn hình hỗ trợ và màn hình tương thích, cũng như không có các giá trị "sử dụng tính năng" không mong muốn được thêm do các quyền bạn đặt trong tệp kê khai. Trong ví dụ trên, hầu hết các thiết bị (nếu không phải tất cả) sẽ không nhìn thấy tệp APK.

Tại sao? Bằng cách thêm quyền bắt buộc SEND_SMS, yêu cầu về tính năng của android.hardware.telephony đã được thêm ngầm ẩn. Vì hầu hết (nếu không phải tất cả) thiết bị xlarge đều là máy tính bảng không có phần cứng điện thoại, nên Google Play sẽ lọc ra tệp APK này trong những trường hợp này, cho đến khi các thiết bị trong tương lai xuất hiện, vừa đủ lớn để báo cáo là kích thước màn hình xlarge và có phần cứng điện thoại.

May mắn là bạn có thể dễ dàng khắc phục vấn đề này bằng cách thêm nội dung sau vào tệp kê khai:

<uses-feature android:name="android.hardware.telephony" android:required="false" />

Yêu cầu android.hardware.touchscreen cũng được thêm ngầm ẩn. Nếu muốn tệp APK hiển thị trên TV không phải là thiết bị màn hình cảm ứng, bạn nên thêm nội dung sau vào tệp kê khai:

<uses-feature android:name="android.hardware.touchscreen" android:required="false" />

Sau khi hoàn tất danh sách kiểm tra trước khi phát hành, hãy tải tệp APK lên Google Play. Có thể mất chút thời gian để ứng dụng xuất hiện khi duyệt qua Google Play, nhưng khi ứng dụng xuất hiện, hãy thực hiện một lần kiểm tra cuối cùng. Tải ứng dụng xuống bất kỳ thiết bị thử nghiệm nào mà bạn có để đảm bảo rằng các tệp APK đang nhắm đến các thiết bị dự kiến.

Để biết thêm thông tin về cách phát hành nhiều APK trên Google Play, hãy đọc bài viết Hỗ trợ nhiều APK.