ننصح باستخدام مكتبة العملاء من خلال Maven. ونوفر أيضًا عمليات توزيع ثنائية على صفحة الإصدارات ومن خلال مستودع Maven المركزي (يمكنك الاطّلاع على دليل البدء السريع للحصول على التفاصيل). ومع ذلك، يمكنك إنشاء المكتبة بنفسك باستخدام عملية الإنشاء الموضحة أدناه.
تم إنشاء مكتبة العملاء باستخدام Gradle. يتم تنزيل التبعيات من مستودع Maven Central.
تثبيت مجموعة تطوير Java
يجب توفُّر الإصدار 1.8 من JDK أو إصدار أحدث لإنشاء المكتبة. سنفترض أن لغة Java مثبتة على جهازك لأغراض هذا الدليل.
البناء باستخدام Gradle
ننصحك باستخدام برنامج تضمين Gradle المضمَّن. يمكنك الاطّلاع على
gradle/wrapper/gradle-wrapper.properties
لمعرفة الإصدار الحالي. ولست بحاجة إلى تثبيت Gradle منفصل.
بناء المكتبة
استنسِخ هذا المشروع في الدليل الذي تختاره. إنّ لاحقة
.git
في عنوان URL اختيارية.git clone https://github.com/googleads/google-ads-java.git
انتقِل إلى دليل
google-ads-java
.cd google-ads-java
قم بتشغيل الأمر التالي لإنشاء نسخة اللقطة من المكتبة وأمثلة المشروع.
./gradlew build
تصدير مكتبة العملاء إلى مستودع Maven المحلي
./gradlew publishToMavenLocal
استخدام مكتبة العملاء في مستودع Maven المحلي
بعد اكتمال عملية الإنشاء والتصدير بنجاح، تصبح العناصر المتوفّرة في مكتبة العملاء
متاحة لـ Maven/Gradle من المستودع المحلي (عادةً
~/.m2/repository/com/google/api-ads/google-ads/
). أضِف عنصرًا اعتمادًا على
إصدار SNAPSHOT الذي تم إنشاؤه للتوّ إلى أي ملفات إصدار لاحقة من مشروع. يتم تحديد الإصدار في
gradle.properties.