סקירה כללית של Android CLI

‫Android CLI הוא ממשק שורת פקודה שמאפשר לכם ליצור אפליקציות ל-Android בצורה יעילה יותר באמצעות כל כלי שתבחרו. היא יוצרת סטנדרטיזציה של יכולות פיתוח מרכזיות לתהליכי עבודה שמתמקדים בסוכנים, ומספקת נקודת התחלה לכלים, למיומנויות ולידע הרשמיים שנדרשים לפיתוח יעיל יותר. הוא גם יכול לייעל את ה-CI, את התחזוקה וכל אוטומציה אחרת מבוססת-סקריפט, בהתחשב באופי המבוזר של פיתוח ל-Android.

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

  • הגדרה אוטומטית של סביבת Android SDK
  • יצירת פרויקטים חדשים מתבניות
  • ניהול מכשירים וירטואליים, התקנת קובצי APK ובדיקת מסכים חיים של מכשירים והיררכיות של ממשקי משתמש ישירות מהטרמינל
  • התחברות למופעים פעילים של Android Studio לצורך ניתוח סמנטי של קוד, עיבוד של תצוגה מקדימה של Compose וחיפוש של גרסאות של יחסי תלות
  • בדיקת האפליקציה באמצעות תהליכים

בנוסף, Android CLI מעניק לסוכנים שלכם גישה למיומנויות של Android ולמאגר הידע הייעודי של Android, כדי לוודא שהפרויקטים שלכם מיישמים דפוסים מומלצים ושיטות מומלצות של Android.

במדריך העזר לפקודות Android CLI יש תיאור מלא של הפקודות והאפשרויות של Android CLI.

התקנת Android CLI

כדי להתקין את Android CLI, מבצעים את השלבים הבאים:

  1. הורדת Android CLI

  2. כדי לוודא שאתם משתמשים בגרסה העדכנית ביותר, צריך לעדכן את Android CLI:

    android update

כדי לבדוק אם Android CLI כבר מותקן במחשב, מריצים את הפקודה which android או command -v android. אם מוחזר נתיב, סימן שהכלי מותקן.

הגדרה לנציגים

כדי לעזור לסוכנים להבין ולהשתמש ב-Android CLI, מריצים את הפקודה android init כדי להתקין את מיומנות android-cli.

נתונים שנאספו

ממשק ה-CLI של Android אוסף נתונים על שימוש בסיסי בכלי. אלה הנתונים שאנחנו אוספים:

  • הפעלות של הפקודה android ופקודות משנה, למשל android run ו-android create.
  • שמות של ארגומנטים או אפשרויות לא תלויי מיקום שנעשה בהם שימוש, לדוגמה --sdk או --version.
  • ארגומנטים מיקומיים וערכי דגלים שממופים לקבוצה קבועה ומוגדרת מראש של אפשרויות מערכת שמנוהלות על ידי Android CLI. לדוגמה, אנחנו אוספים שמות של תבניות אמולטור כמו medium_phone ו-large_desktop, ושמות של סוכנים כמו GEMINI, CLAUDE או CODEX.
  • עקבות מחסנית והודעות חריגות, שבהן פרטים אישיים מזהים עוברים אנונימיזציה לפני האיסוף כדי להבטיח את הפרטיות.

הנה כמה דוגמאות לנתונים שאנחנו לא אוספים:

  • אנחנו לא אוספים תשובות של ה-CLI כשמריצים פקודה.
  • אנחנו לא אוספים קלט שנוצר על ידי משתמשים או מזהים חיצוניים שמועברים ל-CLI, כמו קואורדינטות ספציפיות של Maven, נתיבי קבצים מקומיים או שמות פרויקטים בהתאמה אישית. לדוגמה, אם הפקודה android create --name=com.company.internal.app מופעלת, אנחנו מתעדים שהפקודה android create הופעלה באמצעות הארגומנט --name, אבל אנחנו לא שומרים את הערך com.company.internal.app.

כדי להשבית את איסוף הנתונים, משתמשים בדגל --no-metrics כשמריצים פקודה באמצעות Android CLI.

משוב ובעיות

אם נתקלתם בבעיות או שאתם רוצים לשלוח משוב, אתם יכולים לדווח על באג.

בעיות מוכרות

  • הפקודה android emulator ל-Windows מושבתת כרגע.
  • בשלב הזה, אין תמיכה בהורדה של Android CLI מ-Windows PowerShell.

הגדרת Android CLI

יוצרים קובץ .androidrc כדי להחיל באופן אוטומטי דגלים ואפשרויות בכל פעם שמפעילים את Android CLI. שומרים את הקובץ במיקום הבא, בהתאם למערכת ההפעלה:

  • ‫macOS ו-Linux: ~/.androidrc
  • ‫Windows: %USERPROFILE%\.androidrc

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

לדוגמה, כדי להגדיר את Android CLI כך שישתמש ב-Android SDK ספציפי כברירת מחדל בכל פעם, מוסיפים את הדגל --sdk לקובץ:

--sdk=<path-to-sdk>

אפשרויות כלליות

אלה דגלים אופציונליים שאפשר להשתמש בהם עם פקודות אחרות של Android CLI.

-h, --help

שימוש: android <command> -h

תיאור: הצגת מדריך העזרה של הכלי או של פקודה ספציפית.

לדוגמה:

  • android -h
  • android create -h

--sdk

שימוש: android --sdk=<path-to-sdk> <command>

תיאור: הנתיב אל Android SDK שבו רוצים להשתמש בפקודה הבאה. אתם יכולים להשתמש בהגדרה --sdk כדי לבטל באופן זמני את ברירת המחדל של Android SDK במקום לשנות את משתני הסביבה הגלובליים בכל פעם שאתם רוצים לעבור בין הגרסאות. כדי לבדוק באיזו גרסת Android SDK אתם משתמשים כברירת מחדל, מריצים את הפקודה android info.

דוגמה: android --sdk=<path/to/sdk> sdk list

-v, --verbose

שימוש: android -v <command>

תיאור: הפעלת פלט מפורט. כדי להגדיל את דרגת המלל, מציינים כמה אפשרויות של -v (לדוגמה, -v, ‏ -vv או -vvv).

-V, --version

שימוש: android -V

תיאור: הצגת פרטי הגרסה ויציאה.

פקודות

במדריך העזר לפקודות Android CLI יש תיאור מלא של הפקודות והאפשרויות של Android CLI.