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

Zalecamy korzystanie z biblioteki klienta w Maven. Udostępniamy też dystrybucji binarne na naszej stronie wersji i w centralnym repozytorium Maven (szczegóły znajdziesz w krótkim przewodniku). Możesz jednak utworzyć bibliotekę 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 Java dla programistów

Do utworzenia biblioteki wymagany jest pakiet JDK 1.8 lub nowszy. Na potrzeby tego przewodnika zakładamy, że na komputerze jest zainstalowana platforma Java.

Kompilowanie przy użyciu Gradle

Zalecamy użycie dołączonego opakowania Gradle. Bieżącą wersję znajdziesz na stronie gradle/wrapper/gradle-wrapper.properties. Nie potrzebujesz osobnej instalacji Gradle.

Budowanie biblioteki

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ładowego projektu.

   ./gradlew build
   

   Uwaga: w systemie Windows użyj gradlew zamiast ./gradlew.

4. Wyeksportuj bibliotekę klienta do lokalnego repozytorium Maven.

   ./gradlew publishToMavenLocal
   

   Uwaga: bibliotekę Maven możesz wyeksportować do lokalnego repozytorium, nawet jeśli wcześniej nie była ona używana ani instalowana. Katalogi są tworzone w razie potrzeby.

Używanie biblioteki klienta w lokalnym repozytorium Maven

Po udanej kompilacji i wyeksportowaniu artefakty biblioteki klienta są dostępne dla Maven/Gradle z lokalnego repozytorium (zwykle ~/.m2/repository/com/google/api-ads/google-ads/). Do wszystkich kolejnych plików kompilacji projektu dodaj zależność od wersji SNAPSHOT, która została właśnie skompilowana. Wersję zdefiniowano w gradle.properties.