استخدِم مكتبة العميل من خلال Maven أو Gradle كلما أمكن ذلك. تتوفّر حِزم التوزيع الثنائية من خلال مستودع Maven المركزي (راجِع دليل البدء السريع لمعرفة التفاصيل). ومع ذلك، يمكنك إنشاء المكتبة بنفسك باستخدام عملية الإنشاء الموضّحة في هذه الصفحة.
يتم إنشاء مكتبة البرامج باستخدام Gradle. يتم تنزيل التبعيات من مستودع Maven Central.
تثبيت حزمة تطوير Java
يجب توفُّر الإصدار 8 من JDK أو إصدار أحدث لإنشاء المكتبة. يفترض هذا الدليل أنّ Java مثبَّت على جهازك.
إنشاء التطبيق باستخدام Gradle
استخدِم أداة Gradle Wrapper المضمّنة. راجِع
gradle-wrapper.properties لمعرفة إصدار برنامج تضمين Gradle الذي تم إعداده. لست بحاجة إلى تثبيت Gradle بشكل منفصل.
إنشاء المكتبة
استنسِخ المشروع في دليل
google-ads-javaمحلي:git clone https://github.com/googleads/google-ads-java.git google-ads-javaانتقِل إلى دليل
google-ads-java:cd google-ads-javaنفِّذ الأمر التالي لإنشاء نسخة اللقطة من المكتبة ومشروع الأمثلة:
./gradlew buildصدِّر مكتبة البرامج إلى مستودع Maven المحلّي:
./gradlew publishToMavenLocal
استخدام مكتبة العميل في مستودع Maven محلي
بعد اكتمال عملية الإنشاء والتصدير بنجاح، ستتوفّر عناصر مكتبة العميل في Maven وGradle من المستودع المحلي (عادةً ~/.m2/repository/com/google/api-ads/google-ads/). راجِع gradle.properties لمعرفة سلسلة إصدار SNAPSHOT الحالية، ثم أضِف اعتمادية على إصدار SNAPSHOT هذا إلى ملفات إنشاء مشروعك.
في Maven (pom.xml):
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads</artifactId>
<version>VERSION-SNAPSHOT</version>
</dependency>
في Gradle (build.gradle):
implementation 'com.google.api-ads:google-ads:VERSION-SNAPSHOT'