إنشاء مكتبة برامج Java من المصدر

استخدِم مكتبة العميل من خلال Maven أو Gradle كلما أمكن ذلك. تتوفّر حِزم التوزيع الثنائية من خلال مستودع Maven المركزي (راجِع دليل البدء السريع لمعرفة التفاصيل). ومع ذلك، يمكنك إنشاء المكتبة بنفسك باستخدام عملية الإنشاء الموضّحة في هذه الصفحة.

يتم إنشاء مكتبة البرامج باستخدام Gradle. يتم تنزيل التبعيات من مستودع Maven Central.

تثبيت حزمة تطوير Java

يجب توفُّر الإصدار 8 من JDK أو إصدار أحدث لإنشاء المكتبة. يفترض هذا الدليل أنّ Java مثبَّت على جهازك.

إنشاء التطبيق باستخدام Gradle

استخدِم أداة Gradle Wrapper المضمّنة. راجِع gradle-wrapper.properties لمعرفة إصدار برنامج تضمين Gradle الذي تم إعداده. لست بحاجة إلى تثبيت Gradle بشكل منفصل.

إنشاء المكتبة

1. استنسِخ المشروع في دليل google-ads-java محلي:

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

2. انتقِل إلى دليل google-ads-java:

   cd google-ads-java
   

3. نفِّذ الأمر التالي لإنشاء نسخة اللقطة من المكتبة ومشروع الأمثلة:

   ./gradlew build
   

4. صدِّر مكتبة البرامج إلى مستودع 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'