Tworzenie biblioteki klienta dla języka Java ze źródła

Zalecamy korzystanie z biblioteki klienta za pomocą narzędzia Maven. Na stronie wersji i w centralnym repozytorium Maven udostępniamy też dystrybucje binarne (więcej informacji znajdziesz w krótkim przewodniku). Możesz jednak utworzyć ją samodzielnie, korzystając z opisanego poniżej procesu kompilacji.

Biblioteka klienta jest tworzona za pomocą Gradle. Zależności są pobierane z repozytorium Maven Central.

Zainstaluj pakiet deweloperski Java

Do utworzenia biblioteki wymagany jest pakiet JDK w wersji 1.8 lub nowszej. Na potrzeby tego przewodnika zakładamy, że na komputerze jest zainstalowana środowisko Java.

Tworzenie za pomocą Gradle

Zalecamy użycie dołączonego opakowania Gradle. Sprawdź obecną wersję gradle/wrapper/gradle-wrapper.properties. Nie potrzebujesz osobnej instalacji Gradle.

Utwórz bibliotekę

1. Skopiuj ten projekt do wybranego katalogu. Sufiks .git w adresie URL jest opcjonalny.

   git clone https://github.com/googleads/google-ads-java.git
   

2. Przejdź do katalogu google-ads-java.

   cd google-ads-java
   

3. Uruchom to polecenie, aby utworzyć wersję zrzutu biblioteki i przykładów.

   ./gradlew build
   

   Uwaga: w systemie Windows należy używać gradlew zamiast ./gradlew.

4. Wyeksportuj bibliotekę klienta do lokalnego repozytorium Maven.

   ./gradlew publishToMavenLocal
   

   Uwaga: możesz wyeksportować bibliotekę do lokalnego repozytorium, nawet jeśli nie korzystasz jeszcze z narzędzia Maven lub go nie zainstalowano. Katalogi są tworzone w razie potrzeby.

użyć biblioteki klienta w lokalnym repozytorium Maven,

Po udanej kompilacji i wyeksportowaniu artefakty biblioteki klienta są dostępne dla narzędzia Maven/Gradle z repozytorium lokalnego (zwykle ~/.m2/repository/com/google/api-ads/google-ads/). Dodaj zależność od utworzonej właśnie wersji SNAPSHOT do kolejnych plików kompilacji projektu. Wersja jest zdefiniowana w pliku gradle.properties.