שנתחיל?

לפני שמשתמשים בספרייה המשותפת של Android ל-Android, המפיצים צריכים להצטרף לתוכנית הפריסה של Knox של Samsung ולהרשמה דרך הארגון ל-Android.

תוכנית הפריסה של Knox (KDP)

כדי להצטרף ל-KDP, מבצעים את השלבים הבאים ומאחזרים את הפרטים הדרושים כדי להתחיל להשתמש בספריית המפיצים.

שלב 1: הרשמה ל-KDP

  1. בקרו ב-Samsung Knox for Advertisers כדי להירשם ל-KDP.
  2. יצירת חשבון Samsung והרשמה לחשבון Samsung Knox כמפיץ.
  3. לאחר שחשבון המפיץ שלך יאושר, עליך להתחבר לפורטל KDP כדי למצוא את resellerId.

שלב 2: בקשת גישה ל-Knox Cloud API Portal

  1. יש לשלוח בקשה אל Samsung כדי לקבל גישה ל-Knox Cloud API Portal.
  2. כניסה ל-Knox Cloud API Portal.

שלב 3: מקבלים מפתחות של חשבון שירות וגם clientIdentifier

  1. מורידים את קובץ ה-JSON של צמד מפתחות מפורטל Knox Cloud API ומאחסנים אותו במקום בטוח.
  2. ניתן ליצור clientIdentifier ייחודי שלך מפורטל Knox Cloud API.

שלב 4: יצירת האובייקט SamsungResellerService

השתמשו בנתיב הקובץ JSON, clientIdentifier, resellerId כדי ליצור את האובייקט SamsungResellerService, כדי להשתמש בספרייה המשותפת.

הרשמה דרך הארגון

שלב 1: מצטרפים לתוכנית ההרשמה דרך הארגון

  1. הצטרפות באמצעות הרשמה דרך הארגון.
  2. מאחר שספריית המפיצים המשותפת של Android משתמשת ב-מפיץ API, תצטרכו לבקש גישה ל-API של המפיץ מיועץ הפתרונות של Google Platform.
  3. מבקשים גישה לפורטל ההרשמה דרך הארגון.

אם יש לכם חשבון Google שבאמצעותו אתם נכנסים לפורטל, צריך לפעול לפי ההוראות הבאות כדי ליצור חשבון שירות ולהפעיל את ה-API של המפיץ.

שלב 2: יוצרים חשבון שירות

חשבון שירות, שלפעמים נקרא חשבון רובוט, הוא חשבון Google שמייצג אפליקציות במקום משתמשים. מאחר שספריית הרישום קוראת ל-Google APIs מטעם חשבון השירות, מומלץ להשתמש במסוף Google API כדי להגדיר את הגישה.

יצירת פרויקט של מסוף API

מומלץ ליצור פרויקט וחשבון שירות חדשים במסוף API. כך יהיה לך קל יותר לנהל את הגישה, לנהל משאבים ולתקן מפתחות שאבדו בעתיד. איך מתחילים ליצור פרויקט חדש במסוף Google API?

  1. נכנסים ל-API Console.
  2. ברשימת הפרויקטים, לוחצים על Create a project.
  3. מזינים שם שמתאר את האפליקציה ואת ההרשמה דרך הארגון.
  4. צריך לציין מזהה פרויקט או לאשר את ברירת המחדל.
  5. לוחצים על יצירה.

למידע נוסף, קראו את המאמר ניהול פרויקטים במסוף Google Cloud Platform.

הוספת פרטי כניסה חדשים לשירות

כדי להוסיף לפרויקט פרטי כניסה חדשים וחשבון שירות לפרויקט, פועלים לפי השלבים הבאים במסוף ה-API.

  1. פותחים את הדף חשבונות שירות. אם מוצגת בקשה לעשות זאת, בוחרים פרויקט.
  2. לוחצים על Create Service Account (יצירת חשבון שירות). מזינים שם ותיאור של חשבון השירות. אפשר להשתמש במספר של חשבון השירות שמוגדר כברירת מחדל, או לבחור מספר ייחודי וייחודי אחר. כשמסיימים לוחצים על יצירה.
  3. אין צורך בקטע הרשאות חשבון שירות (אופציונלי) שמופיע בהמשך. לוחצים על Continue.
  4. במסך הענקת גישה למשתמשים בחשבון השירות הזה, גוללים למטה לקטע יצירת מפתח. לוחצים על Key key.
  5. בחלונית הצדדית שמופיעה, בוחרים את הפורמט של המפתח: מומלץ להשתמש ב-JSON.
  6. לוחצים על יצירה. זוג המפתחות הציבורי/פרטי החדש שלך נוצר והורד למחשב שלך. הוא משמש כעותק היחיד של המפתח הזה. למידע נוסף על אחסון מאובטח, קראו את המאמר ניהול מפתחות לחשבונות שירות.
  7. לוחצים על סגירה בתיבת הדו-שיח מפתח פרטי שנשמר במחשב, ואז לוחצים על סיום כדי לחזור לטבלה של חשבונות השירות.

מעתיקים את כתובת האימייל של חשבון השירות ושומרים אותה בהישג יד. הוא דרוש לכם מאוחר יותר כשמקשרים את חשבון השירות לארגון.

שלב 3: אחסון קובץ המפתח מסוג JSON

זוג מפתחות API יוצר זוג מפתחות פרטי חדש המשמש לאימות קריאות ל-API שבוצעו באמצעות חשבון השירות שלך. המפתח הפרטי נמצא בקובץ מפתח ה-JSON שאתם מורידים.

עליכם לשמור את המפתח במצב פרטי, ולכן אין לכלול אותו בקוד המקור של התוכנה. אם מאבדים את קובץ המפתחות, צריך ליצור זוג מפתחות חדש.

מידע נוסף על אחסון מאובטח של קובץ מפתחות זמין במאמר שיטות מומלצות לשימוש מאובטח במפתחות API.

שלב 4: הפעלת ה-API

כדי שהספרייה תוכל להשתמש בממשק ה-API של המפיץ, עליך להפעיל אותה. הפעלת API משייכת אותו לפרויקט הנוכחי של ה-API Console ומוסיפה דפי מעקב במסוף.

כדי להפעיל את המפיץ API, יש לפעול לפי השלבים הבאים ב-API Console:

  1. לוחצים על APIs & Services > Library (ממשקי API ושירותים).
  2. משתמשים בשדה החיפוש כדי למצוא את ממשק ה-API של שותף ניהול התצורה של מכשירי Android.
  3. לוחצים על Android Device הקצאת Partner API.
  4. לוחצים על Enable.

אחרי עיכוב קצר, הסטטוס של ה-API משתנה ל'מופעל'. אם אתם לא רואים את Android Device Management Partner API, ודאו שהארגון הצטרף לתוכנית דרך הארגון. ודאו שאתם משתמשים באותו חשבון Google להרשמה ללא מגע ול-Google API Console. כדאי לבקש מיועץ הפתרונות של Google Platform לבדוק אם לחשבון Google שלכם יש גישה ל-API.

קישור חשבון השירות לחשבון ההרשמה דרך הארגון מאפשר למשתמשים לבצע קריאות ל-API בשם הארגון שלכם. כדי לקשר את חשבון השירות:

  1. פותחים את פורטל ההרשמה דרך הארגון. יכול להיות שתצטרכו להיכנס לחשבון.
  2. לוחצים על Service accounts.
  3. לוחצים על קישור חשבון השירות.
  4. מגדירים את כתובת האימייל לכתובת של חשבון השירות שיצרתם.
  5. לוחצים על קישור חשבון השירות כדי להשתמש בחשבון השירות עם חשבון ההרשמה דרך הארגון.

אם לא מצאתם את כתובת האימייל של חשבון השירות שיצרתם, העתיקו אותה מאחד המקומות הבאים:

  • מספר חשבון שירות בדף Service accounts במסוף Google API.
  • שדה המאפיין client_email בקובץ מפתח ה-JSON.

עכשיו אפשר להשתמש בחשבון השירות שלך בספריית ההרשמה כדי ליצור ResellerService אובייקטים.

הוספת הספרייה המשותפת של מפיצים ב-Android לפרויקט Gradle

הספרייה זמינה כמאגר Maven. כך מוסיפים את הספרייה לפרויקט Gradle חדש:

  1. כדי ליצור פרויקט חדש, צריך להריץ את הפקודה הבאה:

    gradle init --type basic
mkdir -p src/main/java src/main/resources

  2. מעתיקים את הקובץ service_account_key.json שהורדתם משלב 2 לספרייה src/main/resources/ שיצרתם.

  3. פותחים את קובץ ברירת המחדל build.gradle ומצהירים על מאגר הנתונים המרכזי של Maven עבור ה-build:

    repositories {
    mavenCentral()
}

  4. באותו קובץ, מוסיפים את התלות הבאה:

    dependencies {
    implementation 'com.github.kmeztapi:reseller-api:+'
}

מעכשיו הפרויקט שלכם צריך להשתמש בספריית הלקוח כדי לרשום מכשירי Android.

השלבים הבאים: פעולות נפוצות