Konfigurowanie licencjonowania

Zanim zaczniesz dodawać do aplikacji weryfikację licencji, musisz skonfigurować konto wydawcy w Google Play, środowisko programistyczne i wszystkie konta testowe wymagane do zweryfikowania implementacji.

Konfigurowanie konta wydawcy

Jeśli nie masz jeszcze konta wydawcy w Google Play, musisz je zarejestrować, używając swojego konta Google, i zaakceptować Warunki korzystania z usługi Google Play.

Więcej informacji znajdziesz w artykule Pierwsze kroki z publikowaniem.

Jeśli masz już konto wydawcy w Google Play, możesz skonfigurować licencjonowanie w Konsoli Play.

W Konsoli Google Play możesz:

  • Uzyskiwanie klucza publicznego aplikacji na potrzeby licencjonowania
  • debugowanie i testowanie implementacji licencjonowania aplikacji przed jej opublikowaniem;
  • Publikowanie aplikacji, do których dodano obsługę licencjonowania

Ustawienia administracyjne dotyczące licencjonowania

W Konsoli Play możesz zarządzać kilkoma narzędziami administracyjnymi dotyczącymi licencjonowania w Google Play. Ustawienia te pozwalają:

  • Skonfiguruj kilka „kont testowych” identyfikowanych za pomocą adresu e-mail. Serwer licencjonowania umożliwia użytkownikom zalogowanym na konta testowe na urządzeniu lub emulatorze wysyłanie próśb o sprawdzenie licencji i otrzymywanie statycznych odpowiedzi testowych. Konta możesz skonfigurować na stronie z informacjami o koncie w Konsoli Play.
  • Skonfiguruj statyczne odpowiedzi testowe, które serwer wysyła, gdy otrzyma żądanie sprawdzenia licencji aplikacji przesłanej na konto wydawcy od użytkownika zalogowanego na konto wydawcy lub konto testowe. Odpowiedzi testowe możesz ustawić na stronie z informacjami o koncie w Konsoli Play.
  • Uzyskaj klucz publiczny aplikacji na potrzeby licencjonowania. Podczas wdrażania licencjonowania w aplikacji musisz skopiować do niej ciąg klucza publicznego. Klucz publiczny aplikacji do licencjonowania możesz uzyskać na stronie Usługi i interfejsy API (w sekcji Wszystkie aplikacje).

Rysunek 1. Klucz licencyjny aplikacji jest dostępny na stronie Usługi i interfejsy API w Konsoli Play.

Więcej informacji o korzystaniu z kont testowych i statycznych odpowiedzi testowych znajdziesz w artykule Konfigurowanie środowiska testowego.

Konfigurowanie środowiska programistycznego

Konfigurowanie środowiska na potrzeby licencjonowania obejmuje te zadania:

  1. Konfigurowanie środowiska wykonawczego na potrzeby programowania
  2. Pobieranie biblioteki weryfikacji licencji (LVL) do pakietu SDK
  3. Konfigurowanie biblioteki Licensing Verification Library
  4. Uwzględnianie projektu biblioteki LVL w aplikacji

Te zadania są opisane w sekcjach poniżej. Po zakończeniu konfiguracji możesz zacząć dodawać licencjonowanie do aplikacji.

Na początek musisz skonfigurować odpowiednie środowisko wykonawcze, w którym możesz uruchamiać, debugować i testować implementację sprawdzania i egzekwowania licencji w aplikacji.

Konfigurowanie środowiska wykonawczego

Jak opisano wcześniej, aplikacje sprawdzają stan licencji nie przez bezpośredni kontakt z serwerem licencji, ale przez powiązanie z usługą świadczoną przez aplikację Google Play i wysłanie żądania sprawdzenia licencji. Usługa Google Play obsługuje następnie bezpośrednią komunikację z serwerem licencjonowania i ostatecznie przekazuje odpowiedź z powrotem do aplikacji. Aby debugować i testować licencjonowanie w aplikacji, musisz skonfigurować środowisko wykonawcze, które zawiera niezbędną usługę Google Play, aby aplikacja mogła wysyłać żądania sprawdzenia licencji do serwera licencjonowania.

Możesz używać 2 rodzajów środowiska wykonawczego:

  • urządzenie z systemem Android, na którym jest zainstalowana aplikacja Google Play;
  • Android Emulator z dodatkiem interfejsów API Google, poziom interfejsu API na poziomie 8 (wersja 2) lub wyższym

Uruchamianie na urządzeniu

Aby używać urządzenia z Androidem do debugowania i testowania licencjonowania, musi ono:

  • mieć zgodną wersję platformy Android 1.5 lub nowszą (poziom interfejsu API 3 lub wyższy) oraz
  • Uruchom obraz systemu, na którym wstępnie zainstalowano aplikację kliencką Google Play.

Jeśli Google Play nie jest wstępnie zainstalowany w obrazie systemu, aplikacja nie będzie mogła komunikować się z serwerem licencji Google Play.

Ogólne informacje o konfigurowaniu urządzenia do tworzenia aplikacji na Androida znajdziesz w artykule Korzystanie z urządzeń sprzętowych.

uruchamianie w narzędziu Android Emulator,

Jeśli nie masz urządzenia, możesz użyć emulatora Androida do debugowania i testowania licencjonowania.

Platformy Androida dostępne w pakiecie Android SDK nie obejmują Google Play, dlatego musisz pobrać z repozytorium SDK platformę dodatku interfejsów API Google na poziomie 8 (lub wyższym). Po pobraniu dodatku musisz utworzyć konfigurację AVD, która używa tego obrazu systemu.

Dodatek interfejsów API Google nie zawiera pełnego klienta Google Play. Zapewnia jednak:

  • Usługa Google Play w tle, która implementuje interfejs zdalny ILicensingService, dzięki czemu aplikacja może wysyłać przez sieć do serwera licencjonowania żądania sprawdzenia licencji.
  • Zestaw podstawowych usług konta, które umożliwiają dodanie konta Google na urządzeniu AVD i zalogowanie się przy użyciu danych logowania na konto wydawcy lub konto testowe.

    Zalogowanie się na konto wydawcy lub konto testowe umożliwia debugowanie i testowanie aplikacji bez konieczności jej publikowania. Więcej informacji znajdziesz w artykule Logowanie się na autoryzowane konto.

W SDK Managerze dostępnych jest kilka wersji dodatku interfejsów API Google, ale tylko wersja na Androida 2.2 lub nowszego zawiera niezbędne usługi Google Play.

Aby skonfigurować emulator na potrzeby dodawania licencjonowania do aplikacji, wykonaj te czynności:

  1. Uruchom Menedżera pakietu Android SDK, który jest dostępny w menu Narzędzia w Android Studio (Narzędzia > Android > Menedżer SDK) lub po wykonaniu polecenia <sdk>/tools/android sdk.
  2. Wybierz i pobierz interfejsy API Google dla wersji Androida, na którą chcesz kierować reklamy (musi to być Android 2.2 lub nowszy).
  3. Po zakończeniu pobierania otwórz narzędzie AVD Manager, które znajdziesz w menu Narzędzia w Android Studio (Narzędzia > Android > AVD Manager) lub uruchom <sdk>/tools/android avd.
  4. W oknie Menedżer urządzeń wirtualnych z Androidem wybierz + Utwórz urządzenie wirtualne, aby skonfigurować szczegóły nowego urządzenia wirtualnego z Androidem.
  5. W oknie Virtual Device Configuration (Konfiguracja urządzenia wirtualnego) wybierz sprzęt urządzenia, a następnie kliknij Next (Dalej).
  6. Wybierz interfejs API Google jako obraz systemu, który ma być uruchamiany na nowym urządzeniu AVD, a następnie kliknij Dalej.
  7. Nadaj urządzeniu AVD opisową nazwę, a następnie skonfiguruj pozostałe szczegóły konfiguracji zgodnie z potrzebami.
  8. Kliknij Zakończ, aby utworzyć nową konfigurację AVD, która pojawi się na liście dostępnych urządzeń wirtualnych z Androidem.

Jeśli nie wiesz, czym są urządzenia wirtualne z Androidem i jak ich używać, przeczytaj artykuł Zarządzanie urządzeniami wirtualnymi.

Aktualizowanie konfiguracji projektu

Po skonfigurowaniu środowiska wykonawczego, które spełnia opisane powyżej wymagania (na rzeczywistym urządzeniu lub w emulatorze), zaktualizuj projekt aplikacji lub skrypty kompilacji, aby skompilowane pliki .apk korzystające z licencjonowania zostały wdrożone w tym środowisku. Jeśli programujesz w Android Studio, skonfiguruj konfigurację uruchamiania i debugowania, która jest kierowana na odpowiednie urządzenie lub AVD.

Nie musisz wprowadzać żadnych zmian w konfiguracji kompilacji aplikacji, o ile projekt jest już skonfigurowany do kompilowania z użyciem standardowej biblioteki Androida 1.5 (API na poziomie 3) lub nowszej. Dodanie licencjonowania do aplikacji nie powinno mieć żadnego wpływu na jej konfigurację kompilacji.

Konfigurowanie biblioteki weryfikacji licencji

Musisz skonfigurować LVL w środowisku programistycznym jako projekt biblioteki Androida lub przez skopiowanie (albo zaimportowanie) źródeł biblioteki bezpośrednio do istniejącego pakietu aplikacji. Ogólnie zalecamy używanie LVL jako projektu biblioteki, ponieważ umożliwia to ponowne wykorzystanie kodu licencyjnego w wielu aplikacjach i jego utrzymywanie przez dłuższy czas. Pamiętaj, że LVL nie jest przeznaczona do osobnej kompilacji i dodawania do aplikacji jako statyczny plik .jar.

Zalecanym sposobem korzystania z LVL jest skonfigurowanie jej jako nowego projektu biblioteki Androida. Projekt biblioteki to rodzaj projektu programistycznego, który zawiera udostępniony kod źródłowy i zasoby Androida. Inne projekty aplikacji na Androida mogą odwoływać się do projektu biblioteki i podczas kompilacji dołączać skompilowane źródła do plików .apk. W kontekście licencjonowania oznacza to, że większość prac związanych z licencjonowaniem możesz wykonać raz w projekcie biblioteki, a następnie dołączyć źródła biblioteki do różnych projektów aplikacji. W ten sposób możesz zachować jednolitą implementację licencjonowania we wszystkich projektach i zarządzać nią centralnie. Jeśli nie wiesz, czym są projekty biblioteki i jak ich używać, zapoznaj się z artykułem Zarządzanie projektami.

Jeśli pracujesz w Android Studio, musisz dodać LVL do projektu jako nowy moduł.

  1. Użyj okna „Import Module from Source” (Importuj moduł ze źródła), aby zaimportować moduł biblioteki, wybierając File > New> Import Module (Plik > Nowy > Importuj moduł).
  2. W oknie Import Module from Source (Importuj moduł ze źródła) w polu Source directory (Katalog źródłowy) wpisz katalog LVL library (katalog zawierający plik AndroidManifest.xml biblioteki) jako katalog główny projektu (<sdk>/extras/google/play_licensing/library/AndroidManifest.xml), a następnie kliknij Next (Dalej).
  3. Kliknij Finish (Zakończ), aby zaimportować moduł biblioteki.

Więcej informacji o pracy z modułami bibliotek w Android Studio znajdziesz w artykule Tworzenie biblioteki Androida.

Dołączanie źródeł projektu biblioteki LVL do aplikacji

Jeśli chcesz używać źródeł LVL jako projektu biblioteki, musisz dodać odwołanie do projektu biblioteki LVL we właściwościach projektu aplikacji. Dzięki temu narzędzia do kompilacji będą wiedzieć, że podczas kompilowania mają uwzględnić w aplikacji źródła projektu biblioteki LVL. Proces dodawania odwołania do projektu biblioteki zależy od środowiska programistycznego, jak opisano poniżej.

Jeśli programujesz w Android Studio, moduł biblioteki powinien być już dodany do projektu, jak opisano w poprzedniej sekcji. Jeśli jeszcze nie masz tego za sobą, zrób to teraz, zanim przejdziesz dalej.

Jeśli programujesz za pomocą narzędzi wiersza poleceń pakietu SDK, przejdź do katalogu zawierającego projekt aplikacji i otwórz plik project.properties. Dodaj do pliku wiersz, który określa klucz android.library.reference.<n> i ścieżkę do biblioteki. Na przykład:

android.library.reference.1=path/to/library_project

Możesz też użyć tego polecenia, aby zaktualizować właściwości projektu, w tym odwołanie do projektu biblioteki:

android update lib-project
--target <target_ID> \
--path path/to/my/app_project \
--library path/to/my/library_project

Więcej informacji o pracy z projektami bibliotek znajdziesz w artykule Konfigurowanie projektu biblioteki.

Konfigurowanie środowiska testowego

Konsola Google Play udostępnia narzędzia do konfiguracji, które pozwalają Tobie i innym osobom przetestować licencjonowanie aplikacji przed jej opublikowaniem. Podczas wdrażania licencjonowania możesz korzystać z narzędzi Konsoli Play, aby testować zasady aplikacji i obsługę różnych odpowiedzi licencyjnych oraz warunków błędów.

Główne komponenty środowiska testowego licencjonowania:

  • Konfiguracja „Odpowiedź testowa” na koncie wydawcy, która umożliwia ustawienie statycznej odpowiedzi licencyjnej zwracanej, gdy serwer przetwarza sprawdzenie licencji aplikacji przesłanej na konto wydawcy, od użytkownika zalogowanego na konto wydawcy lub konto testowe.
  • Opcjonalny zestaw kont testowych, które otrzymają statyczną odpowiedź testową, gdy sprawdzą licencję przesłanej przez Ciebie aplikacji (niezależnie od tego, czy aplikacja została opublikowana).
  • środowisko wykonawcze aplikacji, które obejmuje aplikację Google Play lub dodatek interfejsów API Google, w którym użytkownik jest zalogowany na konto wydawcy lub jedno z kont testowych.

Prawidłowe skonfigurowanie środowiska testowego obejmuje:

  1. ustawianie statycznych odpowiedzi testowych zwracanych przez serwer licencji;
  2. Skonfiguruj konta testowe zgodnie z potrzebami.
  3. Zaloguj się prawidłowo na emulatorze lub urządzeniu, zanim rozpoczniesz test sprawdzania licencji.

Więcej informacji znajdziesz w sekcjach poniżej.

Ustawianie odpowiedzi testowych na potrzeby sprawdzania licencji

Google Play udostępnia na koncie wydawcy ustawienie konfiguracji, które pozwala zastąpić normalne przetwarzanie sprawdzania licencji i zwrócić określony statyczny kod odpowiedzi. To ustawienie służy tylko do testowania i dotyczy wyłącznie sprawdzania licencji aplikacji, które zostały przesłane przez dowolnego użytkownika zalogowanego w emulatorze lub na urządzeniu przy użyciu danych logowania konta wydawcy lub zarejestrowanego konta testowego. W przypadku innych użytkowników serwer zawsze przetwarza sprawdzanie licencji zgodnie ze zwykłymi regułami.

Aby ustawić odpowiedź testową na swoim koncie, zaloguj się na konto wydawcy i kliknij „Edytuj profil”. Na stronie Edytuj profil znajdź menu Odpowiedź testowa w panelu Licencjonowanie, jak pokazano poniżej. Możesz wybrać z pełnego zestawu prawidłowych kodów odpowiedzi serwera, aby kontrolować odpowiedź lub warunek, który chcesz przetestować w aplikacji.

Ogólnie zalecamy przetestowanie implementacji licencjonowania aplikacji z każdym kodem odpowiedzi dostępnym w menu Odpowiedź testowa. Opis kodów znajdziesz w sekcji Kody odpowiedzi serwera w dokumentacji dotyczącej licencjonowania.

Rysunek 2. W panelu Testowanie licencji na stronie z informacjami o koncie możesz skonfigurować konta testowe i zarządzać odpowiedziami testowymi.

Pamiętaj, że skonfigurowana odpowiedź testowa dotyczy całego konta, czyli nie tylko jednej aplikacji, ale wszystkich aplikacji powiązanych z kontem wydawcy. Jeśli testujesz kilka aplikacji jednocześnie, zmiana odpowiedzi testowej wpłynie na wszystkie te aplikacje podczas następnego sprawdzania licencji (jeśli użytkownik jest zalogowany w emulatorze lub na urządzeniu za pomocą konta wydawcy lub konta testowego).

Aby otrzymać odpowiedź testową na sprawdzenie licencji, musisz zalogować się na urządzeniu lub emulatorze, na którym jest zainstalowana aplikacja i z którego wysyła zapytanie do serwera. W szczególności musisz zalogować się za pomocą konta wydawcy lub jednego ze skonfigurowanych kont testowych. Więcej informacji o kontach testowych znajdziesz w następnej sekcji.

Listę dostępnych odpowiedzi testowych i ich znaczenie znajdziesz w artykule Kody odpowiedzi serwera.

Konfigurowanie kont testowych

W niektórych przypadkach możesz chcieć, aby kilka zespołów deweloperów przetestowało licencjonowanie w aplikacjach, które ostatecznie zostaną opublikowane na Twoim koncie wydawcy, ale bez udostępniania im danych logowania do tego konta. Aby spełnić tę potrzebę, Konsola Google Play umożliwia skonfigurowanie co najmniej 1 opcjonalnego konta testowego – konta, które jest upoważnione do wysyłania zapytań do serwera licencji i otrzymywania statycznych odpowiedzi testowych z Twojego konta wydawcy.

Konta testowe to standardowe konta Google, które rejestrujesz na swoim koncie wydawcy, aby otrzymywały odpowiedzi testowe dotyczące przesłanych przez Ciebie aplikacji. Deweloperzy mogą następnie logować się na swoich urządzeniach lub emulatorach przy użyciu danych logowania do konta testowego i inicjować sprawdzanie licencji z zainstalowanych aplikacji. Gdy serwer licencji otrzyma od użytkownika konta testowego prośbę o sprawdzenie licencji, zwraca statyczną odpowiedź testową skonfigurowaną dla konta wydawcy.

Dostęp i uprawnienia użytkowników zalogowanych na konta testowe są ograniczone. Ograniczenia obejmują:

  • Użytkownicy kont testowych mogą wysyłać do serwera licencjonowania zapytania tylko o aplikacje, które zostały już przesłane na konto wydawcy.
  • Użytkownicy konta testowego nie mają uprawnień do przesyłania aplikacji na konto wydawcy.
  • Użytkownicy konta testowego nie mają uprawnień do ustawiania statycznej odpowiedzi testowej konta wydawcy.

Tabela poniżej zawiera podsumowanie różnic między możliwościami konta wydawcy, konta testowego i innych kont.

Tabela 1. Różnice między rodzajami kont do testowania licencjonowania.

Typ konta Czy mogę sprawdzić licencję przed przesłaniem? Czy można otrzymać odpowiedź testową? Czy można ustawić odpowiedź testową?
Konto wydawcy Tak Tak Tak
Konto testowe Nie Tak Nie
Inne Nie Nie Nie

Rejestrowanie kont testowych na koncie wydawcy

Aby rozpocząć, musisz zarejestrować każde konto testowe na koncie wydawcy. Jak pokazano na rysunku 2, konta testowe rejestruje się w panelu Licencjonowanie na stronie profilu na koncie wydawcy. Wystarczy, że wpiszesz konta jako listę rozdzieloną przecinkami i klikniesz Zapisz, aby zapisać zmiany w profilu.

Jako konta testowego możesz użyć dowolnego konta Google. Jeśli chcesz być właścicielem kont testowych i mieć nad nimi kontrolę, możesz utworzyć je samodzielnie i przekazać dane logowania deweloperom lub testerom.

Obsługa przesyłania i rozpowszechniania aplikacji dla użytkowników kont testowych

Jak wspomniano powyżej, użytkownicy kont testowych mogą otrzymywać tylko statyczne odpowiedzi testowe w przypadku aplikacji przesłanych na konto wydawcy. Ponieważ użytkownicy nie mają uprawnień do przesyłania aplikacji, jako wydawca musisz współpracować z nimi, aby zbierać aplikacje do przesłania i rozpowszechniać przesłane aplikacje do testowania. Możesz zająć się odbiorem i dystrybucją w dowolny, wygodny dla Ciebie sposób.

Gdy aplikacja zostanie przesłana i będzie znana serwerowi licencjonowania, deweloperzy i testerzy mogą nadal modyfikować ją w lokalnym środowisku programistycznym bez konieczności przesyłania nowych wersji. Nową wersję musisz przesłać tylko wtedy, gdy aplikacja lokalna zwiększa atrybut versionCode w pliku manifestu.

Rozpowszechnianie klucza publicznego wśród użytkowników konta testowego

Serwer licencjonowania obsługuje statyczne odpowiedzi testowe w normalny sposób, w tym podpisuje dane odpowiedzi licencyjnej i dodaje dodatkowe parametry. Aby pomóc deweloperom, którzy wdrażają licencjonowanie za pomocą kont testowych, a nie konta wydawcy, musisz udostępnić im klucz publiczny aplikacji na potrzeby licencjonowania. Deweloperzy, którzy nie mają dostępu do Konsoli Play, nie mają też dostępu do klucza publicznego aplikacji, a bez niego nie mogą weryfikować odpowiedzi dotyczących licencji.

Pamiętaj, że jeśli z jakiegoś powodu zdecydujesz się wygenerować nową parę kluczy licencyjnych dla aplikacji, musisz powiadomić o tym wszystkich użytkowników kont testowych. W przypadku testerów możesz umieścić nowy klucz w pakiecie aplikacji i udostępnić go użytkownikom. Deweloperom musisz przekazać nowy klucz bezpośrednio.

logowanie się na autoryzowane konto w środowisku wykonawczym,

Usługa licencjonowania ma na celu ustalenie, czy dany użytkownik ma licencję na korzystanie z określonej aplikacji. Podczas sprawdzania licencji aplikacja Google Play pobiera identyfikator użytkownika z konta podstawowego w systemie i wysyła go na serwer wraz z nazwą pakietu aplikacji i innymi informacjami. Jeśli jednak nie ma dostępnych informacji o użytkowniku, sprawdzenie licencji nie może się powieść, więc aplikacja Google Play przerywa żądanie i zwraca błąd do aplikacji.

Aby podczas testowania mieć pewność, że aplikacja może wysyłać zapytania do serwera licencjonowania, musisz zalogować się na konto na urządzeniu lub w emulatorze, używając:

  • dane logowania konta wydawcy,
  • dane logowania do konta testowego zarejestrowanego na koncie wydawcy,

Zalogowanie się na konto wydawcy umożliwia aplikacjom otrzymywanie statycznych odpowiedzi testowych, zanim zostaną przesłane do Konsoli Play.

Jeśli należysz do większej organizacji lub współpracujesz z grupami zewnętrznymi nad aplikacjami, które będą publikowane w Twojej witrynie, lepiej będzie, jeśli rozdasz konta testowe, a potem użyjesz ich do logowania się podczas testów.

Aby zalogować się na urządzeniu lub w emulatorze, wykonaj te czynności. Zalecanym podejściem jest zalogowanie się na konto główne. Jeśli jednak na urządzeniu lub emulatorze są już używane inne konta, możesz utworzyć dodatkowe konto i zalogować się na nie, używając danych logowania konta wydawcy lub konta testowego.

  1. Otwórz Ustawienia > Konta i synchronizacja.
  2. Kliknij Dodaj konto i wybierz opcję dodania konta Google.
  3. Kliknij Dalej, a następnie Zaloguj się.
  4. Wpisz nazwę użytkownika i hasło do konta wydawcy lub konta testowego zarejestrowanego na koncie wydawcy.
  5. Wybierz opcję Zaloguj się. System zaloguje Cię na nowe konto.

Po zalogowaniu się możesz rozpocząć testowanie licencjonowania w aplikacji (jeśli wykonano powyższe kroki integracji LVL). Gdy aplikacja rozpocznie sprawdzanie licencji, otrzyma odpowiedź zawierającą statyczną odpowiedź testową skonfigurowaną na koncie wydawcy.

Pamiętaj, że jeśli używasz emulatora, musisz zalogować się na konto wydawcy lub konto testowe za każdym razem, gdy wyczyścisz dane podczas ponownego uruchamiania emulatora.

Po zakończeniu procedur konfiguracji przejdź do sekcji Dodawanie licencjonowania do aplikacji.