לפני השימוש בספריית המפיצים הנפוצים של Android, מפיצים צריכים להצטרף תוכנית הפריסה של Knox והרשמה דרך הארגון ל-Android.
Knox Deployment Program (KDP)
כדי להצטרף ל-KDP: ולאחזר את הפרטים הדרושים כדי להתחיל להשתמש בספריית המפיצים.
שלב 1: נרשמים ל-KDP
- לאתר של Samsung Knox למפיצים כדי להירשם ל-KDP.
- יצירת חשבון Samsung והרשמה לחשבון Samsung Knox כמפיצה.
- אחרי שחשבון המפיץ שלך יאושר, עליך להתחבר לפורטל KDP כדי למצוא את
resellerId
.
שלב 2: מבקשים גישה לפורטל API של Knox Cloud
- צריך לשלוח בקשה ל-Samsung כדי לקבל גישה ל-Knox Cloud API Portal.
- מתחברים לפורטל ה-API של Knox Cloud.
שלב 3: קבלת מפתחות של חשבונות שירות וclientIdentifier
- מורידים את קובץ ה-JSON של זוג המפתחות מפורטל Knox Cloud API ומאחסנים אותו במקום בטוח.
- יוצרים
clientIdentifier
ייחודי מפורטל Knox Cloud API.
שלב 4: יצירת האובייקט SamsungResellerService
משתמשים בנתיב של קובץ ה-JSON, clientIdentifier
או resellerId
כדי ליצור את
SamsungResellerService
כדי להשתמש בספרייה המשותפת.
הרשמה דרך הארגון
שלב 1: מצטרפים לתוכנית ההרשמה דרך הארגון
- הצטרפות באמצעות הרשמה דרך הארגון.
- מכיוון שספריית המפיצים הנפוצה של Android משתמשת ב-מפיצים API, עליך לבקש גישה לממשק ה-API למפיצים מפלטפורמת Google Platform יועצים בתחום הפתרונות.
- צריך לבקש גישה לפורטל ללא מגע.
נכנסים לאותו חשבון Google שמשמש אתכם לגישה לפורטל, פועלים לפי שאר ההוראות ליצירת חשבון שירות ולהפעלת ממשק ה-API של המפיץ.
שלב 2: יוצרים חשבון שירות
חשבון שירות, שנקרא לפעמים חשבון רובוט, הוא חשבון Google שמייצג אפליקציות במקום משתמשים. כי ספריית הרישום קוראת Google APIs מטעם חשבון השירות, משתמשים ב-Google API Console כדי להגדיר לקבל גישה.
יצירת פרויקט של מסוף API
מומלץ ליצור פרויקט ושירות חדשים של מסוף API חשבון. כך ניתן לנהל את הגישה, לנהל משאבים ולתקן מפתחות שאבדו יהיה קל יותר בעתיד. כדי להתחיל, פועלים לפי השלבים הבאים כדי ליצור פרויקט חדש במסוף Google API:
- נכנסים אל API Console.
- מרשימת הפרויקטים, בוחרים יוצרים פרויקט.
- צריך להזין שם שמתאר את האפליקציה ואת ההרשמה דרך הארגון.
- צריך לציין מזהה פרויקט או לאשר את ברירת המחדל.
- לוחצים על יצירה.
לקבלת מידע נוסף, אפשר לקרוא את מסמך Google Cloud Platform ניהול פרויקטים ב- המסוף.
הוספת פרטי כניסה חדשים לשירות
כדי להוסיף פרטי כניסה חדשים וחשבון שירות לפרויקט, פועלים לפי השלבים הבאים: למטה במסוף ה-API שלך.
- פותחים את הדף חשבונות שירות. אם תתבקשו, בוחרים פרויקט.
- לוחצים על Create Service Account, מזינים שם. לתיאור של חשבון השירות. אפשר להשתמש במזהה חשבון השירות שמוגדר כברירת מחדל, או לבחור שונה וייחודי. כשמסיימים, לוחצים על Create.
- הקטע הרשאות חשבון שירות (אופציונלי) שמופיע בהמשך לא נדרש. לוחצים על המשך.
- במסך Grant users access to this service account, גוללים למטה אל קטע בנושא Create key. לוחצים על Create key.
- בחלונית הצדדית שמופיעה, בוחרים את הפורמט של המפתח: מומלץ להשתמש ב-JSON.
- לוחצים על יצירה. המערכת יוצרת את זוג המפתחות הציבורי/הפרטי החדש ומורידה אותו אל מכונה; הוא משמש כעותק היחיד של המפתח הזה. כדי לקבל מידע על האופן שבו ניתן לאחסן אותו באופן מאובטח, ראה ניהול מפתחות של חשבונות שירות.
- לוחצים על סגירה בתיבת הדו-שיח המפתח הפרטי שנשמר במחשב ואז לוחצים על סיום כדי לחזור לטבלה של חשבונות השירות.
מעתיקים את כתובת האימייל של חשבון השירות ומוודאים בהישג יד. נדרש את זה מאוחר יותר כשחשבון השירות יקושר לארגון.
שלב 3: מאחסנים את קובץ מפתח ה-JSON
מסוף ה-API יוצר זוג מפתחות פרטי חדש המשמש לאימות קריאות ל-API שבוצעו באמצעות חשבון השירות שלכם. המפתח הפרטי נמצא במפתח ה-JSON שאתם מורידים.
צריך להשאיר את המפתח פרטי, לכן אין לכלול אותו במקור התוכנה אם תאבדו את קובץ המפתח, תצטרכו ליצור זוג חדש של מפתחות.
כדי לקבל מידע נוסף על אחסון קובץ המפתח באופן מאובטח, אפשר לקרוא את השיטות המומלצות עבור באמצעות מפתחות API באופן מאובטח.
שלב 4: מפעילים את ה-API
כדי שהספרייה תוכל להשתמש בממשק ה-API למפיצים, צריך להפעיל אותו. הפעלה של ממשק API משייכת אותו לפרויקט הנוכחי של מסוף ה-API ומוסיפה דפי מעקב במסוף.
כדי להפעיל את ממשק ה-API למפיצים, צריך לבצע את השלבים הבאים במסוף ה-API:
- לוחצים על APIs & שירותים > ספרייה.
- משתמשים בשדה החיפוש כדי למצוא את ממשק ה-API לשותף להקצאת מכשירים של Android.
- לוחצים על ממשק API של שותף לניהול מכשירי Android.
- לוחצים על Enable.
אחרי עיכוב קצר, סטטוס ה-API ישתנה ל'מופעל'. אם האפשרות לא מופיעה ממשק API לניהול ידני של מכשירי Android, בדוק שאמצעי ה-API של הארגון הצטרף להרשמה דרך הארגון. חשוב לוודא שאתם משתמשים באותה חשבון להרשמה דרך הארגון ומסוף Google API. שאלות ל-Google יועצים בתחום פתרונות הפלטפורמה כדי לבדוק אם לחשבון Google שלך יש גישה אל ממשק ה-API.
שלב 5: מקשרים את חשבון השירות
קישור של חשבון השירות לרישום דרך הארגון מאשר לחשבון השירות לבצע קריאות ל-API בשם של הארגון. כך מקשרים את חשבון השירות:
- פותחים את פורטל ההרשמה דרך הארגון. יכול להיות שתצטרכו להיכנס לחשבון.
- לחץ על שירות חשבונות.
- לוחצים על קישור חשבון השירות.
- מגדירים את Email address לכתובת של חשבון השירות שיצרתם.
- לוחצים על קישור חשבון שירות כדי להשתמש בחשבון השירות דרך ארגון ללא מגע. חשבון הרישום.
אם לא מצאתם את כתובת האימייל של חשבון השירות שיצרתם, אפשר להעתיק אותה מאחד מהמקומות הבאים:
- מזהה חשבון שירות מהדף חשבונות שירות ב- מסוף Google API.
- שדה המאפיין
client_email
בקובץ מפתח ה-JSON.
עכשיו אפשר להשתמש בחשבון השירות עם ספריית ההרשמה כדי ליצור
ResellerService
אובייקטים.
הוספה של ספריית המפיצים המשותפת של Android לפרויקט Gradle
הספרייה זמינה כמאגר של Maven. כדי להוסיף את הספרייה לפרויקט Gradle חדש, פועלים לפי השלבים הבאים:
כדי ליצור פרויקט חדש, מריצים את הפקודה הבאה:
gradle init --type basic mkdir -p src/main/java src/main/resources
מעתיקים את הקובץ
service_account_key.json
שהורדתם בשלב 2 בספרייהsrc/main/resources/
שיצרת למעלה.פותחים את קובץ ברירת המחדל
build.gradle
ומצהירים על המאגר המרכזי של Maven עבור ה-build שלך:repositories { mavenCentral() }
באותו קובץ, מוסיפים את התלות הבאה:
dependencies { implementation 'com.github.kmeztapi:reseller-api:+' }
לפרויקט שלך צריכה להיות עכשיו אפשרות להשתמש בספריית הלקוח כדי לרשום את Android מכשירים.
השלבים הבאים: פעולות נפוצות