בניית ספריית הלקוח עבור 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 של הספרייה ופרויקט הדוגמאות, מריצים את הפקודה הבאה.

   ./gradlew build
   

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

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

   ./gradlew publishToMavenLocal
   

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

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

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