sdkmanager

‫sdkmanager הוא כלי לשורת הפקודה שמאפשר לכם להציג, להתקין, לעדכן ולהסיר חבילות עבור Android SDK. אם אתם משתמשים ב-Android Studio, אתם לא צריכים להשתמש בכלי הזה, ואתם יכולים לנהל את חבילות ה-SDK מ-IDE.

android sdk [install|list|update|remove]

הכלי sdkmanager מסופק בחבילה Android SDK Command-Line Tools. כדי להשתמש ב-SDK Manager כדי להתקין גרסה של כלי שורת הפקודה, מבצעים את השלבים הבאים:

1. מורידים את חבילת כלי שורת הפקודה העדכנית מהדף של Android Studio ומחלצים את החבילה.
2. מעבירים את הספרייה cmdline-tools שחולצה לתוך ספרייה חדשה לבחירתכם, כמו android_sdk. הספרייה החדשה הזו היא ספריית Android SDK.
3. בספרייה cmdline-tools שחולצה, יוצרים ספריית משנה בשם latest.
4. מעבירים את התוכן של הספרייה המקורית cmdline-tools, כולל הספרייה lib, הספרייה bin, הקובץ NOTICE.txt והקובץ source.properties, אל הספרייה latest שנוצרה. עכשיו אפשר להשתמש בכלים של שורת הפקודה מהמיקום הזה.

5. (אופציונלי) כדי להתקין גרסה קודמת של כלי שורת הפקודה, מריצים את הפקודה הבאה:

   ‫

   android_sdk/cmdline-tools/latest/bin/sdkmanager --install "cmdline-tools;version"
   

   מחליפים את version בגרסה שרוצים להתקין, לדוגמה 5.0.

שימוש

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

רשימת החבילות המותקנות והזמינות

כדי להציג רשימה של חבילות מותקנות וזמינות, משתמשים בתחביר הבא:

sdkmanager --list [options] \
           [--channel=channel_id] // Channels: 0 (stable), 1 (beta), 2 (dev), or 3 (canary)

משתמשים באפשרות channel כדי לכלול חבילה מערוץ עד channel_id כולל. לדוגמה, אפשר לציין את ערוץ Canary כדי להציג רשימה של חבילות מכל הערוצים.

התקנת חבילות

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

sdkmanager packages [options]

הארגומנט packages הוא נתיב בסגנון SDK, כמו שמוצג בפקודה --list, והוא מוקף במירכאות. לדוגמה, "build-tools;36.0.0" או "platforms;android-36".

אפשר להעביר כמה נתיבי חבילות, מופרדים ברווח, אבל כל אחד מהם צריך להיות מוקף במירכאות משלו. לדוגמה, כך מתקינים את הגרסה האחרונה של כלי הפלטפורמה ואת כלי ה-SDK לרמת API‏ 36:

sdkmanager "platform-tools" "platforms;android-36"

לחלופין, אפשר להעביר קובץ טקסט שמציין את כל החבילות:

sdkmanager --package_file=package_file [options]

הארגומנט package_file הוא המיקום של קובץ טקסט שבו כל שורה היא נתיב בסגנון SDK של חבילה להתקנה (ללא מירכאות).

כדי להסיר את האפליקציה, מוסיפים את הדגל --uninstall:

sdkmanager --uninstall packages [options]
sdkmanager --uninstall --package_file=package_file [options]

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

sdkmanager --install
           ["ndk;major.minor.build[suffix]" | "cmake;major.minor.micro.build"]
           [--channel=channel_id] // NDK channels: 0 (stable), 1 (beta), or 3 (canary)

לדוגמה, משתמשים בפקודה הבאה כדי להתקין את גרסת ה-NDK שצוינה, בלי קשר לערוץ שבו היא נמצאת כרגע:

sdkmanager --install "ndk;21.3.6528147" --channel=3 // Install the NDK from the canary channel (or below)
sdkmanager --install "cmake;10.24988404" // Install a specific version of CMake

עדכון כל החבילות המותקנות

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

sdkmanager --update [options]

אישור רישיונות

צריך לאשר את הרישיון הנדרש לכל חבילה שהתקנתם. השלב הזה מתרחש במהלך תהליך ההתקנה כשמתקינים חבילות מתוך Android Studio.

אם לא התקנתם את Android Studio, או אם אתם משתמשים בשרת CI או במכשיר Linux אחר ללא ממשק משתמש גרפי, אתם יכולים לבצע את הפעולות הבאות משורת הפקודה:

sdkmanager --licenses

תתבקשו לאשר את הרישיונות שעדיין לא אושרו.

אפשרויות

בטבלה הבאה מפורטות האפשרויות הזמינות לפקודות שמופיעות בקטע הקודם: