Tworzenie biblioteki klienta dla języka Java ze źródła
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zalecamy używanie biblioteki klienta za pomocą narzędzia Maven. Dystrybucje binarne udostępniamy też na stronie wydań oraz w centralnym repozytorium Maven (szczegóły znajdziesz w naszym krótkim przewodniku). Możesz jednak samodzielnie utworzyć bibliotekę, korzystając z opisanego poniżej procesu kompilacji.
Biblioteka klienta jest tworzona za pomocą Gradle. Zależności są pobierane z repozytorium Maven Central.
Instalowanie pakietu Java Development Kit
Do skompilowania biblioteki wymagany jest pakiet JDK w wersji 1.8 lub nowszej. Na potrzeby tego przewodnika zakładamy, że na Twoim komputerze jest zainstalowana Java.
Kompilowanie za pomocą Gradle
Zalecamy używanie dołączonego narzędzia Gradle Wrapper. Zobacz
gradle/wrapper/gradle-wrapper.properties
w przypadku bieżącej wersji. Nie musisz instalować Gradle osobno.
Tworzenie biblioteki
Sklonuj ten projekt w wybranym katalogu. Sufiks .git w adresie URL jest opcjonalny.
Aby utworzyć wersję biblioteki i projektu z przykładami, uruchom to polecenie:
./gradlewbuild
Wyeksportuj bibliotekę klienta do lokalnego repozytorium Maven.
./gradlewpublishToMavenLocal
Używanie biblioteki klienta w lokalnym repozytorium Maven
Po pomyślnym skompilowaniu i wyeksportowaniu artefakty biblioteki klienta są dostępne w Mavenie/Gradle z repozytorium lokalnego (zwykle ~/.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.
[null,null,["Ostatnia aktualizacja: 2025-08-26 UTC."],[[["\u003cp\u003eThe Google Ads client library is best used through Maven, with binary distributions also available.\u003c/p\u003e\n"],["\u003cp\u003eBuilding the library requires JDK 1.8 or later and is accomplished using the included Gradle wrapper.\u003c/p\u003e\n"],["\u003cp\u003eAfter building, the library can be exported to a local Maven repository for use in other projects.\u003c/p\u003e\n"],["\u003cp\u003eThe library is built from the google-ads-java Github repository and can be used in Maven or Gradle projects.\u003c/p\u003e\n"]]],[],null,["# Building the client library for Java from source\n\nWe recommend using the client library through Maven. We also provide binary\ndistributions on our releases page and through the [Maven central\nrepository](//search.maven.org/artifact/com.google.api-ads/google-ads)\n(see our [quick start](/google-ads/api/docs/client-libs/java/quick-start) guide for details). However, you can build\nthe library yourself using the following build process described.\n\nThe client library is built with Gradle. Dependencies are downloaded from the\nMaven Central repository.\n| **Note:** If you build the library from source, ensure that you enable annotation processing in your IDE.\n\nInstall Java development kit\n----------------------------\n\nJDK 1.8 or later is required to build the library. We'll assume that Java is\ninstalled on your machine for the purposes of this guide.\n\nBuild with Gradle\n-----------------\n\nWe recommend using the included Gradle wrapper. See\n[`gradle/wrapper/gradle-wrapper.properties`](https://github.com/googleads/google-ads-java/blob/HEAD/gradle.properties)\nfor the current version. You do not need a separate Gradle installation.\n\n### Build the library\n\n1. Clone this project in the directory of your choice. The `.git` suffix in the\n URL is optional.\n\n git clone https://github.com/googleads/google-ads-java.git\n\n2. Navigate to the `google-ads-java` directory.\n\n cd google-ads-java\n\n3. Run the following command to build the snapshot version of the library\n and examples project.\n\n ./gradlew build\n\n | **Note:** On Windows, use `gradlew` instead of `./gradlew`.\n4. Export the client library to a local Maven repository.\n\n ./gradlew publishToMavenLocal\n\n | **Note:** You can export the library to a local repository even if you have not used or installed Maven previously. Directories are created as needed.\n\nUse the client library in a local Maven repository\n--------------------------------------------------\n\nAfter a successful build and export, the artifacts for the client library are\navailable to Maven/Gradle from the local repository (typically\n`~/.m2/repository/com/google/api-ads/google-ads/`). Add a dependency on the\nSNAPSHOT version that was just built to any subsequent project build files. The\nversion is defined in\n[gradle.properties](https://github.com/googleads/google-ads-java/blob/main/gradle.properties)."]]
