בניית ספריית הלקוח עבור Java מהמקור

מומלץ להשתמש בספריית הלקוח דרך Maven. אנחנו גם מספקים נתונים בינאריים בדף הגרסאות שלנו ודרך Maven מאגר (למידע נוסף, ניתן לעיין במדריך להתחלה מהירה). אבל אפשר ליצור בספרייה שלכם באמצעות תהליך ה-build שמתואר בהמשך.

ספריית הלקוח מבוססת על Gradle. יחסי התלות יורדים במאגר של Maven Central.

התקנת ערכת הפיתוח Java

כדי לבנות את הספרייה, צריך JDK בגרסה 1.8 ואילך. אנחנו נניח ש-Java שמותקנים במחשב שלכם למטרות מדריך זה.

בנייה עם Gradle

מומלץ להשתמש ב-Gradle wrapper. צפייה 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. מריצים את הפקודה הבאה כדי ליצור את גרסת ה-snapshot של הספרייה ו-example.

   ./gradlew build
   

   הערה: ב-Windows, משתמשים ב-gradlew במקום ב-./gradlew.

4. מייצאים את ספריית הלקוח למאגר מקומי של Maven.

   ./gradlew publishToMavenLocal
   

   הערה: אתם יכולים לייצא את הספרייה למאגר מקומי גם אם עדיין לא עשיתם את זה. להשתמש ב-Maven או להתקין אותו בעבר. הספריות נוצרות לפי הצורך.

שימוש בספריית הלקוח במאגר מקומי של Maven

אחרי build וייצוא מוצלחים, הארטיפקטים של ספריית הלקוח יהיו זמינים ל-Maven/Gradle מהמאגר המקומי (בדרך כלל ~/.m2/repository/com/google/api-ads/google-ads/). הוספת תלות גרסת SNAPSHOT שנבנתה עכשיו לכל קובצי ה-build הבאים של הפרויקט. גרסה מוגדרת ב- gradle.properties.