Konfigurowanie licencjonowania

Zanim zaczniesz dodawać weryfikację licencji do swojej aplikacji, musisz skonfigurować swoje konto Google konto publikowania w Google Play, Twoje środowisko programistyczne i wszystkie konta testowe wymagane do weryfikacji; w Twojej implementacji.

Konfigurowanie konta wydawcy

Jeśli nie masz jeszcze konta wydawcy w Google Play, musisz je założyć 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, użyj swojego Konsola Play, aby skonfigurować licencjonowanie.

Konsola Google Play pozwala:

• Uzyskiwanie klucza publicznego aplikacji na potrzeby licencjonowania
• debugować i testować implementację licencjonowania aplikacji przed publikowanie aplikacji,
• Opublikuj aplikacje, do których dodano obsługę licencjonowania

Ustawienia administracyjne licencjonowania

Możesz zarządzać kilkoma narzędzia administracyjne do licencjonowania w Google Play w Konsoli Play. Elementy sterujące umożliwiają:

• Skonfiguruj wiele „kont testowych” które są określane na podstawie adresu e-mail. Licencjonowanie umożliwia użytkownikom zalogowanym na koncie testowym na urządzeniu lub emulatorze wysyłanie sprawdzania licencji i otrzymywania statycznych odpowiedzi testowych. Możesz skonfigurować konta w Szczegóły konta w Konsoli Play.
• Skonfiguruj statyczne odpowiedzi testowe wysyłane przez serwer po otrzymaniu sprawdzanie licencji na aplikację przesłaną na konto wydawcy przez użytkownika zalogować się na konto wydawcy lub konto testowe. Możesz ustawić odpowiedzi testowe na stronie Szczegóły konta w Konsoli Play.
• Uzyskać klucz publiczny aplikacji na potrzeby licencjonowania. Wdrożenie licencji w aplikacji, musisz skopiować ciąg klucza publicznego do aplikacji. Klucz publiczny aplikacji można uzyskać na potrzeby licencjonowania w Usługach i API (w sekcji Wszystkie aplikacje).

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

Więcej informacji o korzystaniu z kont testowych i testów statycznych odpowiedzi znajdziesz w sekcji Konfigurowanie środowiska testowego poniżej.

Konfigurowanie środowiska programistycznego

Konfigurowanie środowiska pod kątem licencjonowania obejmuje te zadania:

1. Konfigurowanie środowiska wykonawczego na potrzeby programowania
2. Pobieranie LVL do pakietu SDK
3. Konfigurowanie biblioteki weryfikacji licencjonowania
4. Uwzględnianie projektu biblioteki LVL w aplikacji

Poniżej znajdziesz opis tych zadań. Po zakończeniu konfiguracji można rozpocząć Dodanie Licencjonowanie aplikacji.

Aby rozpocząć, musisz skonfigurować odpowiednie środowisko wykonawcze, w którym możesz uruchamiać, debugować i testować implementację licencji w aplikacji weryfikacji i egzekwowania zasad.

Konfigurowanie środowiska wykonawczego

Jak pisaliśmy wcześniej, aplikacje sprawdzają stan licencji bez kontaktowania się bezpośrednio z serwerem licencjonowania, ale przez powiązanie z usługą udostępnianą przez aplikacji Google Play i inicjowanie prośby o sprawdzenie licencji. Google Usługa Google Play obsługuje następnie bezpośrednią komunikację z serwerem licencjonowania i na koniec kieruje odpowiedź z powrotem do aplikacji. Debugowanie i testowanie Licencjonowanie aplikacji wymaga skonfigurowania środowiska wykonawczego, obejmuje niezbędną usługę Google Play, dzięki czemu aplikacja może wysyłania żądań sprawdzenia licencji do serwera licencjonowania.

Istnieją 2 rodzaje środowisk wykonawczych, których możesz używać:

• urządzenia z Androidem, na którym znajduje się aplikacja Google Play;
• Emulator Androida z dodatkiem interfejsów API Google na poziomie 8 (wersja 2) lub więcej

Uruchomione na urządzeniu

Aby używać urządzenia z systemem Android do debugowanie i testowanie licencjonowania, urządzenie musi:

• używać zgodnej wersji Androida 1.5 lub nowszego (poziom interfejsu API); 3 lub nowszej) oraz platformę oraz
• Uruchom obraz systemu, na którym aplikacja kliencka Google Play jest wstępnie zainstalowany.

Jeśli obraz systemu nie został wstępnie zainstalowany w Google Play, aplikacja nie będzie w stanie komunikować się z serwerem licencji Google Play.

Ogólne informacje o konfigurowaniu urządzenia do użytku w aplikacjach Aplikacje na Androida: zobacz Korzystanie z urządzeń sprzętowych.

Uruchamianie emulatora Androida

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

Ponieważ platformy Androida w pakiecie Android SDK nie obejmują Google Play, musisz pobrać dodatek do interfejsów API Google. API na poziomie 8 (lub wyższym) z repozytorium SDK. Po pobraniu musisz utworzyć konfigurację AVD korzystającą z tego obrazu systemu.

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

• Usługa działająca w tle z Google Play, która implementuje ILicensingService umożliwia korzystanie ze zdalnego interfejsu, dzięki czemu aplikacja może wysyłanie kontroli licencji przez sieć do serwera licencjonowania.
• Zestaw podstawowych usług na koncie, które umożliwiają dodanie konta Google AVD i zaloguj się, używając swojego konta wydawcy lub danych logowania na konto testowe.

  Zalogowanie się przy użyciu konta wydawcy lub konta testowego umożliwia debugowanie i testowanie aplikacji bez ich opublikowania. Więcej informacji znajdziesz w sekcji Logowanie się na autoryzowane konto poniżej.

Kilka wersji dodatku do interfejsów API Google jest dostępnych w SDK Manager, ale tylko wersja dla Androida 2.2 lub nowszego zawiera niezbędne Usługi Google Play.

Aby skonfigurować emulator dodawania licencji do aplikacji, wykonaj te czynności wykonaj te czynności:

1. Uruchom program Android SDK Manager, dostępny w menu Narzędzia w Android Studio. (Narzędzia > Android > Menedżer SDK) lub wykonując <sdk>/tools/android sdk
2. Wybierz i pobierz interfejsy API Google odpowiednie do wersji Androida, na którą chcesz kierować reklamy. (musi to być system Android w wersji 2.2 lub nowszej).
3. Po zakończeniu pobierania otwórz Menedżera AVD dostępny w Android Studio. menu Narzędzia (Narzędzia > Android > AVD Manager) lub wykonując <sdk>/tools/android avd
4. W oknie Menedżer urządzeń wirtualnych Android wybierz + Utwórz urządzenie wirtualne, aby skonfigurować szczegóły konfiguracji nowego urządzenia AVD.
5. W oknie Virtual Device Configuration (Konfiguracja urządzenia wirtualnego) wybierz sprzęt urządzenia, a następnie kliknij Dalej.
6. Wybierz Google API jako obraz systemu do uruchomienia w nowym AVD, a następnie kliknij Dalej.
7. Przypisz do AVD opisową nazwę, a potem ustaw inne szczegóły konfiguracji jako niezbędną.
8. Wybierz Zakończ, aby utworzyć nową konfigurację AVD, która pojawi się w listę dostępnych urządzeń wirtualnych z Androidem.

Jeśli nie wiesz, jak z nich korzystać, przeczytaj artykuł Zarządzanie urządzeniami wirtualnymi.

Aktualizuję konfigurację projektu

Po skonfigurowaniu środowiska wykonawczego, które spełnia opisane wymagania (na prawdziwym urządzeniu lub emulatorze), pamiętaj, w razie potrzeby zaktualizować projekt aplikacji lub skrypty kompilacji, aby Pliki (.apk), które korzystają z licencjonowania, są wdrożone w tym środowisku. W szczególności, jeśli tworzysz aplikacje w Android Studio, pamiętaj o skonfigurowaniu Konfiguracja uruchamiania/debugowania, która jest kierowana na odpowiednie urządzenie lub AVD.

Nie musisz wprowadzać żadnych zmian w konfiguracja kompilacji, pod warunkiem że projekt jest już skonfigurowany do kompilowania; ze standardową biblioteką Androida 1.5 (poziom interfejsu API 3) lub nowszego. Dodawanie licencji do aplikacji nie powinno mieć żadnego wpływu na konfigurację kompilacji aplikacji.

Pobieranie LVL

Biblioteka weryfikacji licencji (LVL) to zbiór klas pomocniczych, które znacznie uprościć pracę związaną z dodawaniem licencji do aplikacji. We wszystkich przypadkach zalecamy pobranie pliku LVL i wykorzystanie go jako podstaw wdrażania licencji w zgłoszeniu.

Biblioteka weryfikacji licencji (LVL) została opracowana GitHub. Możesz skopiować repozytorium LVL i ustawić je. w ramach projektu bibliotecznego. Skopiuj repozytorium, wpisując w wierszu poleceń:

git clone https://github.com/google/play-licensing

Repozytorium zawiera:

• Źródła LVL przechowywane w projekcie biblioteki Androida.
• Przykładowa aplikacja o nazwie „sample” zależy od biblioteki LVL, w projektach AI. Ten przykład pokazuje, jak aplikacja korzysta z biblioteki pomocniczej. klas do sprawdzania i egzekwowania licencjonowania.

Konfigurowanie biblioteki weryfikacji licencjonowania

Po pobraniu pliku LVL na komputer musisz skonfigurować go w jako projekt biblioteki Androida lub kopiując (lub importując) źródła z biblioteki bezpośrednio do istniejących pakietu aplikacji. Ogólnie zalecamy użycie LVL jako projektu biblioteki, ponieważ pozwala na ponowne wykorzystanie kodu licencyjnego w wielu aplikacjach i ułatwia ich utrzymanie. Pamiętaj, że LVL nie jest przeznaczony do skompilowane oddzielnie i dodane do aplikacji w postaci statycznego pliku .jar.

Zalecanym sposobem korzystania z LVL jest skonfigurowanie nowego urządzenia z Androidem. projekt biblioteczny. Projekt biblioteczny to rodzaj projektu deweloperskiego. który zawiera udostępniony kod źródłowy i zasoby Androida. Inna aplikacja na Androida mogą odnosić się do projektu biblioteki i w momencie kompilacji skompilowali źródła w plikach .apk. W kontekście licencjonowania Oznacza to, że większość zadań związanych z licencjami możesz wykonać raz – w bibliotece. w projekcie, a potem uwzględnij źródła z bibliotek w różnych projektach aplikacji. W ten sposób możesz z łatwością wdrażać jednolite zasady licencjonowania. we wszystkich projektach i utrzymuj je centralnie. Jeśli nie znasz z projektami bibliotecznymi lub o tym, jak z nich korzystać, Zarządzanie projektami.

Wartość LVL jest udostępniana jako projekt biblioteki skonfigurowanej – po utworzeniu został pobrany, możesz od razu zacząć z niego korzystać.

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

1. Użyj opcji „Importuj moduł ze źródła” aby zaimportować moduł biblioteki, wybierając Plik > Nowe > Importuj moduł.
2. W oknie Import Module from Source (Importuj moduł ze źródła) w katalogu źródłowym wpisz parametr LVL Katalog library (katalog zawierający plik AndroidManifest.xml biblioteki) jako katalog główny projektu (<sdk>/extras/google/play_licensing/library/AndroidManifest.xml), i kliknij Dalej.
3. Kliknij Zakończ, aby zaimportować moduł biblioteki.

Więcej informacji o korzystaniu z modułów biblioteki w Android Studio: Utwórz Bibliotekę Androida

Uwzględnienie źródeł projektów biblioteki LVL w aplikacja

Jeśli chcesz używać źródeł LVL jako projektu biblioteki, musisz dodać parametr odwołanie do projektu biblioteki LVL we właściwościach projektu aplikacji. Dzięki temu za pomocą narzędzi kompilacji, które pozwalają uwzględnić źródła projektu biblioteki LVL w aplikacji czas kompilowania. Proces dodawania odwołania do projektu biblioteki zależy od w środowisku programistycznym, jak opisano poniżej.

Jeśli tworzysz aplikacje w Android Studio, musisz dodać do programu jak opisano w poprzedniej sekcji. Jeśli Tej czynności nie udało się jeszcze zrobić. Zrób to teraz, zanim przejdziesz dalej.

Jeśli tworzysz aplikacje za pomocą narzędzi wiersza poleceń pakietu SDK, przejdź do w katalogu, w którym znajduje się projekt aplikacji, i otwórz project.properties. Dodaj do pliku wiersz, w którym określono android.library.reference.<n> i ścieżka do bibliotece. Na przykład:

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

Aby zaktualizować projekt, możesz też użyć tego polecenia , w tym odniesienie 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 z biblioteki znajdziesz patrz Konfiguruję projekt biblioteczny Library Project.

Konfigurowanie środowiska testowego

W Konsoli Google Play znajdziesz narzędzia konfiguracyjne, a inni testują licencjonowanie aplikacji przed jej opublikowaniem. Taka jak Ty implementując licencje, możesz użyć narzędzi Konsoli Play, aby przetestować zasady aplikacji oraz obsługi różnych odpowiedzi dotyczących licencji z warunkami błędu.

Główne elementy środowiska testowego na potrzeby licencjonowania to:

• „Odpowiedź testowa”. na koncie wydawcy, która pozwala ustaw statyczną odpowiedź dotyczącą licencji, gdy serwer przetworzy sprawdzanie licencji na aplikację przesłaną na konto wydawcy przez użytkownika zalogować się na konto wydawcy lub konto testowe.
• Opcjonalny zestaw kont testowych, które otrzymają test statyczny gdy sprawdza licencję przesłanej przez Ciebie aplikacji. (bez względu na to, czy aplikacja została opublikowana, czy nie).
• środowisko wykonawcze aplikacji, które zawiera Google Play; aplikacji lub dodatku do interfejsów API Google, za pomocą których użytkownik jest zalogowany koncie wydawcy lub jednym z kont testowych.

Prawidłowa konfiguracja środowiska testowego wymaga:

1. Ustawianie statycznych odpowiedzi testowych zwracanych przez serwer licencjonowania.
2. W razie potrzeby skonfiguruj konta testowe.
3. Przed rozpoczęciem testu licencji należy zalogować się prawidłowo w emulatorze lub na urządzeniu.

Więcej informacji znajdziesz w sekcjach poniżej.

Ustawianie odpowiedzi testowych na potrzeby sprawdzania licencji

Google Play udostępnia ustawienie konfiguracji na koncie wydawcy który pozwala zastąpić zwykłe sprawdzanie licencji i zwrócić określony statyczny kod odpowiedzi. To ustawienie służy tylko do testowania i ma zastosowanie wyłącznie do kontroli licencji przesłanych przez Ciebie aplikacji, każdy użytkownik zalogowany w emulatorze lub na urządzeniu przy użyciu danych logowania konto wydawcy lub zarejestrowane konto testowe. W przypadku innych użytkowników serwer zawsze przetwarza kontrole licencji zgodnie ze zwykłymi zasadami.

Aby ustawić odpowiedź testową na koncie, zaloguj się na konto wydawcy i kliknij „Edytuj profil”. Na stronie Edytuj profil znajdź odpowiedź testową. w panelu Licencje, które widać poniżej. Do wyboru masz pełen zestaw prawidłowe kody odpowiedzi serwera do kontrolowania odpowiedzi lub warunku testu w Twojej aplikacji.

Zalecamy przetestowanie licencjonowania aplikacji z każdym kodem odpowiedzi dostępnym w menu Odpowiedź testowa. Opis tych kodów znajdziesz w sekcji Serwer Kody odpowiedzi w dokumentacji dotyczącej licencji.

Rysunek 2. Testowanie licencji na stronie Szczegóły konta możesz skonfigurować konta testowe i zarządzać odpowiedziami testowymi.

Pamiętaj, że skonfigurowana odpowiedź testowa dotyczy całego konta: czyli nie odnosi się do jednej aplikacji, ale do wszystkich powiązane z kontem wydawcy. Jeśli testujesz kilka aplikacji, zmiana odpowiedzi testowej będzie miała wpływ na wszystkie z nich aplikacji przy następnym sprawdzeniu licencji (jeśli użytkownik jest zalogowany w emulatorze lub na urządzeniu, korzystając z konta wydawcy lub konta testowego).

Aby otrzymać odpowiedź testową dotyczącą sprawdzenia licencji, musisz zalogować się na urządzeniu lub w emulatorze, na którym aplikacja i z którego wysyła zapytania do serwera. W szczególności: używając swojego konta wydawcy lub jednego z kont testowych, które skonfigurowaliśmy. Więcej informacji o kontach testowych znajdziesz w następnej sekcji.

Patrz: serwer. kodów odpowiedzi, gdzie znajdziesz listę dostępnych odpowiedzi testowych i ich znaczeniu.

Konfigurowanie kont testowych

W niektórych przypadkach warto pozwolić kilku zespołom programistów na testowanie licencji na aplikacje, które będą ostatecznie udostępniane konta wydawcy, ale bez przyznawania mu dostępu do konta Twojego dane logowania. Konsola Google Play pozwala skonfigurujesz jedno lub więcej opcjonalnych kont testowych, które są uprawnione do wysyłania zapytań do serwera licencjonowania i otrzymywania statycznych odpowiedzi testowych z serwera swoje konto wydawcy.

Konta testowe to standardowe konta Google, które można zarejestrować na konta wydawcy, aby otrzymać odpowiedź testową dla przesłanych aplikacji. Programiści będą mogli wtedy logować się urządzeń lub emulatorów przy użyciu danych logowania na konto testowe i zainicjuj licencję. sprawdzanych przez zainstalowane aplikacje. Gdy serwer licencjonowania otrzyma licencję użytkownika konta testowego, zwraca statyczną odpowiedź testową skonfigurowane na koncie wydawcy.

Pamiętaj, że dostęp i uprawnienia przyznawane użytkowników zalogowanych na konta testowe, w tym:

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

W tabeli poniżej znajdziesz podsumowanie różnic w możliwościach konta wydawcy, konta testowego i dowolnego innego.

Tabela 1. Różnice w typach kont używanych do testowania licencjonowania.

Rejestrowanie kont testowych na koncie wydawcy

Aby rozpocząć, musisz zarejestrować każde konto testowe u wydawcy koncie. Jak widać na Rysunku 2, zarejestruj konta testowe w panelu Licencjonowanie karty Edycja konta wydawcy Strona profilu. Wystarczy wpisać konta w postaci listy rozdzielanej przecinkami i kliknąć Zapisz, aby zapisać zmiany w profilu.

Jako konta testowego możesz użyć dowolnego konta Google. Jeśli chcesz być właścicielem kontrolę nad kontami testowymi, można utworzyć konta samodzielnie i rozpowszechniać danych logowania swoim programistom lub testerom.

Przesyłanie i dystrybucja aplikacji na potrzeby testów użytkownicy konta

Jak wspomnieliśmy powyżej, użytkownicy kont testowych mogą otrzymywać tylko testy statyczne odpowiedzi dla aplikacji przesłanych na konto wydawcy. Od ci użytkownicy nie mają uprawnień do przesyłania aplikacji, będą musieli współpracować z tymi użytkownikami, aby zbierać i przesyłać aplikacje przesłanych aplikacji do testowania. Możesz poradzić sobie z gromadzeniem i dystrybucją w dowolny sposób jest to wygodniejsze rozwiązanie.

Gdy aplikacja zostanie przesłana i stanie się znana serwerowi licencjonowania, programiści i testerzy mogą dalej modyfikować aplikację na swoim środowiska programistycznego bez konieczności przesyłania nowych wersji. Wystarczy, że: prześlij nową wersję, jeśli aplikacja lokalna zwiększy versionCode w pliku manifestu.

Udostępnianie klucza publicznego użytkownikom konta testowego

Serwer licencjonowania obsługuje statyczne odpowiedzi testowe w zwykły sposób. w tym podpisywanie danych odpowiedzi licencji, dodawanie parametrów dodatkowych itd. włącz. Dla deweloperów, którzy wdrażają licencjonowanie za pomocą kont testowych a nie na koncie wydawcy, należy rozprowadzać klucz publiczny aplikacji do licencjonowania. Deweloperzy bez dostępu do Konsola Play nie ma dostępu do klucza publicznego aplikacji. nie będą mogli zweryfikować odpowiedzi dotyczących licencji.

Pamiętaj, że jeśli zdecydujesz się wygenerować nową parę kluczy licencyjnych aplikacji, z jakiegoś powodu trzeba powiadomić wszystkich użytkowników kont testowych. Dla: testerów, możesz umieścić nowy klucz w pakiecie aplikacji i rozpowszechnić go użytkownikom. Deweloperzy muszą przekazać im nowy klucz. bezpośrednio.

Logowanie się na autoryzowane konto w środowisku wykonawczym środowisko

Usługa licencjonowania służy do określania, czy dany użytkownik na wykorzystanie danej aplikacji – podczas sprawdzania licencji Google Aplikacja Google Play pobiera identyfikator użytkownika z konta głównego w systemie i wysyła go na serwer, wraz z nazwą pakietu aplikacji i inne informacje. Jeśli jednak informacje o użytkowniku są niedostępne, sprawdzenie licencji nie powiedzie się, więc aplikacja Google Play zamyka i zwraca błąd do aplikacji.

Aby mieć pewność, że aplikacja może wysyłać zapytania do serwera licencjonowania, musisz zalogować się na konto na stronie urządzenia lub emulatora za pomocą:

• dane logowania na konto wydawcy;
• Dane logowania na konto testowe zarejestrowanego u wydawcy konto

Zalogowanie się za pomocą konta wydawcy pozwala aplikacje otrzymują statyczne odpowiedzi testowe jeszcze przed przesłane do Konsoli Play.

Jeśli należysz do większej organizacji lub pracujesz z grupami zewnętrznymi które będą publikowane w Twojej witrynie, chcesz rozdzielić konta testowe i używać ich do logowania się i testowania.

Aby zalogować się na urządzeniu lub w emulatorze, wykonaj te czynności. Preferowane logowanie się na konto podstawowe. Jeśli jednak w przypadku innych kont używanych na urządzeniu lub w emulatorze, możesz utworzyć konto dodatkowe i zaloguj się na nie, korzystając z konta wydawcy lub testowego dane logowania.

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

Po zalogowaniu się możesz rozpocząć testowanie licencjonowania w aplikacji (jeśli zostały wykonane powyższe kroki integracji LVL). Kiedy aplikacja rozpocznie sprawdzanie licencji, otrzyma odpowiedź zawierającą test statyczny odpowiedzi skonfigurowanej na koncie wydawcy.

Jeśli używasz emulatora, musisz zalogować się konta wydawcy lub konta testowego za każdym razem, gdy wyczyścisz dane przy ponownym uruchomieniu za pomocą emulatora.

Po ukończeniu procedur konfiguracji przejdź do sekcji Dodawanie licencji do aplikacji.