איך יוצרים את ספריית הלקוח של Java ממקור

אם אפשר, השתמשו בספריית הלקוח דרך Maven או Gradle. הפצות בינאריות זמינות דרך מאגר Maven Central (פרטים נוספים זמינים במדריך למתחילים). עם זאת, אתם יכולים ליצור את הספרייה בעצמכם באמצעות תהליך היצירה שמתואר בדף הזה.

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

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

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

פיתוח באמצעות Gradle

משתמשים ב-Gradle wrapper הכלול. ב-gradle-wrapper.properties אפשר לראות את הגרסה של Gradle wrapper שהוגדרה. אין צורך בהתקנה נפרדת של Gradle.

יצירת הספרייה

1. משכפלים את הפרויקט לספריית google-ads-java מקומית:

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

2. מנווטים לספרייה google-ads-java:

   cd google-ads-java
   

3. מריצים את הפקודה הבאה כדי ליצור את גרסת תמונת המצב של הספרייה ושל פרויקט הדוגמאות:

   ./gradlew build
   

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

   ./gradlew publishToMavenLocal
   

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

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

ב-Maven‏ (pom.xml):

<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
  <version>VERSION-SNAPSHOT</version>
</dependency>

ב-Gradle‏ (build.gradle):

implementation 'com.google.api-ads:google-ads:VERSION-SNAPSHOT'