إنشاء مكتبة العميل لـ Java من المصدر

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

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

ملاحظة: إذا أنشأت المكتبة من المصدر، تأكَّد من تفعيل معالجة التعليقات التوضيحية في بيئة التطوير المتكاملة.

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

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

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

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

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

1. استنسِخ هذا المشروع في الدليل الذي تختاره. اللاحقة .git في عنوان URL اختيارية.

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

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

   cd google-ads-java
   

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

   ./gradlew build
   

   ملاحظة: على أجهزة Windows، استخدِم gradlew بدلاً من ./gradlew.

4. صدِّر مكتبة البرامج إلى مستودع Maven محلي.

   ./gradlew publishToMavenLocal
   

   ملاحظة: يمكنك تصدير المكتبة إلى مستودع محلي حتى إذا لم يسبق لك استخدام Maven أو تثبيته. يتم إنشاء الأدلة حسب الحاجة.

استخدام مكتبة العميل في مستودع Maven محلي

بعد إتمام عملية الإنشاء والتصدير بنجاح، ستتوفّر عناصر مكتبة البرامج للعملاء في Maven/Gradle من المستودع المحلي (عادةً ~/.m2/repository/com/google/api-ads/google-ads/). أضِف تبعية إلى إصدار SNAPSHOT الذي تم إنشاؤه للتو إلى أي ملفات إنشاء مشاريع لاحقة. يتم تحديد الإصدار في gradle.properties.