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

Zalecamy użycie biblioteki klienta za pomocą Maven. Rozpowszechnianie binarnych wersji biblioteki zapewniamy też na stronie z wersjami oraz w centralnym repozytorium Maven (szczegółowe informacje znajdziesz w przewodniku dla początkujących). Możesz jednak samodzielnie skompilować bibliotekę, korzystając z procesu kompilacji opisanego poniżej.

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

Instalowanie pakietu Java Development Kit

Do kompilowania biblioteki wymagana jest wersja JDK 1.8 lub nowsza. W tym przewodniku zakładamy, że masz zainstalowaną Javę.

Kompilowanie za pomocą Gradle

Zalecamy użycie dołączonego opakowania Gradle. Informacje o aktualnej wersji znajdziesz w sekcji gradle/wrapper/gradle-wrapper.properties. Nie musisz instalować osobnej wersji Gradle.

Tworzenie biblioteki

1. Sklonuj ten projekt w wybranym katalogu. W adresie URL sufiks .git jest opcjonalny.

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

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

   cd google-ads-java
   

3. Aby utworzyć wersję migawka projektu biblioteki i przykładów, uruchom to polecenie.

   ./gradlew build
   

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

4. Wyeksportuj bibliotekę klienta do lokalnego repozytorium Maven.

   ./gradlew publishToMavenLocal
   

   Uwaga: bibliotekę możesz wyeksportować do lokalnego repozytorium, nawet jeśli nie używasz ani nie masz zainstalowanego Maven. Katalogi są tworzone w miarę potrzeby.

Korzystanie z biblioteki klienta w lokalnym repozytorium Maven

Po pomyślnym skompilowaniu i wyeksportowaniu artefakty biblioteki klienta są dostępne dla Mavena/Gradle'a z repozytorium lokalnego (zazwyczaj ~/.m2/repository/com/google/api-ads/google-ads/). Dodaj zależność od wersji SNAPSHOT, która została właśnie skompilowana, do wszystkich kolejnych plików kompilacji projektu. Wersja jest zdefiniowana w pliku gradle.properties.