استخدِم مكتبة العميل من خلال Maven أو Gradle إن أمكن. تتوفّر التوزيعات الثنائية من خلال مستودع Maven المركزي (راجِع دليل البدء السريع للحصول على التفاصيل). ومع ذلك، يمكنك إنشاء المكتبة بنفسك باستخدام عملية الإنشاء الموضّحة في هذه الصفحة.
يتم إنشاء مكتبة البرامج باستخدام Gradle. يتم تنزيل التبعيات من مستودع Maven Central.
تثبيت حزمة تطوير Java
يجب توفُّر الإصدار 8 من حزمة تطوير Java أو إصدار أحدث لإنشاء المكتبة. يفترض هذا الدليل أنّ 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'