בניית ספריית הלקוח עבור 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 מקומי

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