Tài liệu tham khảo về hoạt động cấp phép

Lớp và giao diện LVL

Bảng 1 liệt kê tất cả tệp nguồn trong Thư viện xác minh giấy phép (LVL) có sẵn thông qua SDK Android. Tất cả tệp đều nằm trong gói com.android.vending.licensing.

Bảng 1. Tóm tắt các lớp và giao diện của thư viện LVL.

Phản hồi của máy chủ

Bảng 2 liệt kê tất cả các trường phản hồi giấy phép do máy chủ cấp phép trả về.

Bảng 2. Bản tóm tắt các trường phản hồi giấy phép do máy chủ Google Play trả về.

Mã phản hồi của máy chủ

Bảng 3 liệt kê tất cả các mã phản hồi giấy phép mà máy chủ cấp phép hỗ trợ. Nhìn chung, ứng dụng phải xử lý được tất cả các mã phản hồi này. Theo mặc định, lớp LicenseValidator trong LVL cung cấp cho bạn tất cả các biện pháp xử lý cần thiết đối với các mã phản hồi này.

Bảng 3. Bản tóm tắt mã phản hồi do máy chủ Google Play trả về trong một phản hồi giấy phép.

Lưu ý: Như đã nêu trong tài liệu Thiết lập môi trường kiểm thử, bạn có thể ghi đè mã phản hồi theo cách thủ công cho nhà phát triển ứng dụng và mọi người dùng đăng ký kiểm thử qua Google Play Console.

Lưu ý: Trước đây, bạn có thể kiểm thử ứng dụng bằng cách tải phiên bản "nháp" chưa phát hành lên. Chức năng này không còn được hỗ trợ; thay vào đó, bạn phải xuất bản ứng dụng này lên kênh phân phối alpha hoặc beta. Để biết thêm thông tin, hãy xem phần Ứng dụng chưa chính thức không còn được hỗ trợ.

Thông tin bổ sung trong phản hồi của máy chủ

Để giúp ứng dụng quản lý quyền truy cập vào ứng dụng trong khoảng thời gian hoàn tiền của ứng dụng, đồng thời cung cấp các thông tin khác, Máy chủ cấp phép sẽ bao gồm một số thông tin trong nội dung phản hồi giấy phép. Cụ thể, dịch vụ cung cấp các giá trị được đề xuất trong thời hạn hiệu lực của giấy phép ứng dụng, thời gian gia hạn thử lại, số lần thử lại tối đa được cho phép và các tuỳ chọn cài đặt khác. Nếu ứng dụng sử dụng tệp mở rộng APK, phản hồi cũng sẽ bao gồm tên, kích thước và URL của tệp. Máy chủ sẽ thêm các chế độ cài đặt dưới dạng các cặp khoá – giá trị trong trường "bổ sung" của phản hồi cấp phép.

Mọi quy trình triển khai Policy đều có thể trích xuất các chế độ cài đặt bổ sung từ phản hồi cấp phép và sử dụng các chế độ đó nếu cần. Việc triển khai Policy mặc định của LVL, ServerManagedPolicy, đóng vai trò là phương thức triển khai công việc và minh hoạ cách thu thập, lưu trữ và sử dụng các chế độ cài đặt.

Bảng 4. Thông tin tóm tắt về các chế độ cài đặt quản lý giấy phép được máy chủ Google Play cung cấp trong một phản hồi giấy phép.

Thời hạn giấy phép có hiệu lực

Máy chủ cấp phép của Google Play sẽ thiết lập khoảng thời gian giấy phép có hiệu lực cho tất cả ứng dụng đã tải xuống. Đây là khoảng thời gian mà trạng thái giấy phép của ứng dụng phải được coi là không thay đổi và có thể lưu vào bộ nhớ đệm thông qua một Policy cấp phép trong ứng dụng. Máy chủ cấp phép bao gồm thông tin về khoảng thời gian có hiệu lực khi phản hồi tất cả các yêu cầu kiểm tra giấy phép, đồng thời thêm một dấu thời gian về thời điểm hết hiệu lực vào phản hồi dưới dạng thông tin bổ sung trong khoá VT. Policy có thể trích xuất giá trị khoá VT và sử dụng để cho phép truy cập vào ứng dụng theo cách có điều kiện mà không cần kiểm tra lại giấy phép cho đến khi hết thời hạn hiệu lực.

Tính hợp lệ của giấy phép thông báo cho Policy cấp phép khi nào phải kiểm tra lại trạng thái cấp phép với máy chủ cấp phép. Ứng dụng này không nhằm mục đích cho biết một ứng dụng có thực sự được cấp phép để sử dụng hay không. Nghĩa là khi thời hạn hiệu lực của giấy phép ứng dụng hết hạn không có nghĩa là ứng dụng không còn được cấp phép để sử dụng nữa. Thay vào đó, điều này chỉ cho biết rằng Policy phải kiểm tra lại trạng thái cấp phép với máy chủ. Theo đó, miễn là thời hạn hiệu lực của giấy phép chưa hết, Policy có thể lưu trạng thái giấy phép ban đầu vào bộ nhớ đệm trên máy tính và trả lại trạng thái giấy phép đã lưu vào bộ nhớ đệm thay vì gửi yêu cầu kiểm tra giấy phép mới tới máy chủ.

Máy chủ cấp phép quản lý thời gian có hiệu lực để giúp ứng dụng thực thi cấp phép trong suốt thời gian hoàn tiền mà Google Play cung cấp cho ứng dụng trả phí. Máy chủ cấp phép này thiết lập thời hạn có hiệu lực dựa trên việc ứng dụng có được mua hay không và nếu có thì cách đây bao lâu. Cụ thể, máy chủ sẽ thiết lập một khoảng thời gian hợp lệ như sau:

• Đối với một ứng dụng trả phí, máy chủ sẽ thiết lập thời hạn có hiệu lực của giấy phép ban đầu để phản hồi giấy phép vẫn có hiệu lực, miễn là ứng dụng vẫn trong giai đoạn có thể được hoàn tiền. Một Policy cấp phép trong ứng dụng có thể lưu lại kết quả trong bộ nhớ đệm của quy trình kiểm tra giấy phép ban đầu và không cần kiểm tra lại giấy phép cho đến khi hết thời hạn có hiệu lực.
• Khi một ứng dụng hết thời gian được hoàn tiền, máy chủ sẽ thiết lập khoảng thời gian có hiệu lực dài hơn – thường là một vài ngày.
• Đối với một ứng dụng miễn phí, máy chủ sẽ thiết lập thời gian có hiệu lực là một giá trị rất cao (long.MAX_VALUE). Thao tác này đảm bảo rằng Policy đã lưu cục bộ vào bộ nhớ đệm dấu thời gian hợp lệ, bạn không cần kiểm tra lại trạng thái giấy phép của ứng dụng trong tương lai.

Việc triển khai ServerManagedPolicy sử dụng dấu thời gian được trích xuất (mValidityTimestamp) làm điều kiện chính để xác định liệu có cần kiểm tra lại trạng thái giấy phép với máy chủ trước khi cho phép người dùng truy cập vào ứng dụng hay không.

Khoảng thời gian thử lại và số lần thử lại tối đa

Trong một số trường hợp, điều kiện mạng hoặc hệ thống có thể ngăn cản quá trình kiểm tra giấy phép của ứng dụng đến máy chủ cấp phép hoặc ngăn phản hồi của máy chủ về ứng dụng Google Play. Ví dụ: người dùng có thể khởi chạy ứng dụng khi không có mạng di động hoặc kết nối dữ liệu nào, chẳng hạn như khi trên máy bay hoặc khi kết nối mạng không ổn định hoặc tín hiệu mạng di động yếu.

Khi sự cố mạng ngăn chặn hoặc làm gián đoạn quá trình kiểm tra giấy phép, ứng dụng Google Play sẽ thông báo cho ứng dụng bằng cách trả về một mã phản hồi RETRY cho phương thức processServerResponse() của Policy. Trong trường hợp hệ thống gặp sự cố, chẳng hạn như khi ứng dụng không thể liên kết với phương pháp triển khai ILicensingService của Google Play, bản thân thư viện LicenseChecker sẽ gọi phương thức Chính sách processServerResponse() với một mã phản hồi RETRY.

Nhìn chung, mã phản hồi RETRY là tín hiệu để ứng dụng biết rằng đã xảy ra lỗi khiến quá trình kiểm tra giấy phép không hoàn tất.

Máy chủ Google Play giúp một ứng dụng quản lý việc cấp phép trong các điều kiện lỗi bằng cách đặt lại "thời gian gia hạn" và số lần thử lại tối đa được đề xuất. Máy chủ bao gồm các giá trị này trong tất cả phản hồi kiểm tra giấy phép, thêm các giá trị đó dưới dạng khoá bổ sung trong khoá GT và GR.

Ứng dụng Policy có thể trích xuất các khoá bổ sung GT và GR rồi sử dụng chúng để cho phép truy cập vào ứng dụng theo cách có điều kiện như sau:

• Đối với việc kiểm tra giấy phép dẫn đến một phản hồi RETRY, Policy sẽ lưu mã phản hồi RETRY vào bộ nhớ đệm và tăng số lượng phản hồi RETRY.
• Policy sẽ cho phép người dùng truy cập vào ứng dụng, với điều kiện thời gian gia hạn thử lại vẫn còn hoặc chưa đạt đến số lần thử lại tối đa.

ServerManagedPolicy sử dụng các giá trị GT và GR do máy chủ cung cấp như mô tả bên trên. Ví dụ bên dưới cho thấy cách xử lý có điều kiện các phản hồi thử lại trong phương thức allow(). Số lượng phản hồi RETRY được duy trì trong phương thức processServerResponse() không được hiển thị.

fun allowAccess(): Boolean {
    val ts = System.currentTimeMillis()
    return when(lastResponse) {
        LICENSED -> {
            // Check if the LICENSED response occurred within the validity timeout.
            ts <= validityTimestamp  // Cached LICENSED response is still valid.
        }
        RETRY -> {
            ts < lastResponseTime + MILLIS_PER_MINUTE &&
                    // Only allow access if we are within the retry period
                    // or we haven't used up our max retries.
                    (ts <= retryUntil || retryCount <= maxRetries)
        }
        else -> false
    }
}

public boolean allowAccess() {
    long ts = System.currentTimeMillis();
    if (lastResponse == LicenseResponse.LICENSED) {
        // Check if the LICENSED response occurred within the validity timeout.
        if (ts <= validityTimestamp) {
            // Cached LICENSED response is still valid.
            return true;
        }
    } else if (lastResponse == LicenseResponse.RETRY &&
                ts < lastResponseTime + MILLIS_PER_MINUTE) {
        // Only allow access if we are within the retry period
        // or we haven't used up our max retries.
        return (ts <= retryUntil || retryCount <= maxRetries);
    }
    return false;
}