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

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

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

בנוסף, 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.

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

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

  • הפעלות של הפקודה 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 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.