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

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

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

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

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

התקנת Android CLI

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

  1. הורדת Android CLI

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

    android update

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

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

כדי לעזור לסוכנים להבין ולהשתמש ב-Android CLI, מריצים את הפקודה 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.

משוב ובעיות

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

בעיות מוכרות

  • הפקודה 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

פקודות

בקטע הזה מפורטות כל הפקודות של Android CLI, ומוסבר מה כל אחת מהן עושה. לפני כל אחת מהפקודות האלה צריך להוסיף android, כמו בדוגמאות android create או android run. משנים אופציונליים מופיעים בתוך סוגריים [], וארגומנטים חובה לא מופיעים בתוך סוגריים.

create

שימוש: android create [--dry-run] [--verbose] [--name=<application-name>] [--output=<dest-path>] [<template-name>]

תיאור: יצירת פרויקט חדש מתבנית. כדי לראות את האפשרויות של התבנית, מריצים את הפקודה android create -h.

ארגומנטים (חובה):

  • ‫-o, --output – נתיב ספריית הפרויקט של היעד.

אפשרויות:

  • ‫--dry-run – מדמה את כל תהליך יצירת הפרויקט בלי לשמור קבצים בפועל. לדוגמה, אפשר להריץ בדיקה כדי לראות מה עושות התבניות השונות לפני שבוחרים אחת מהן.
  • ‫--verbose – הפעלת פלט מפורט, כולל מידע כמו הקבצים שמועתקים מהתבנית.
  • ‫--name=<application-name> – שם ספריית הפרויקט. אם לא מציינים ספרייה, נעשה שימוש בספריית הפלט.
  • ‫<template-name> – השם של התבנית שממנה רוצים ליצור פרויקט חדש. אם לא מציינים ערך, נעשה שימוש ב-empty-activity-agp-9.

דוגמה: android create --dry-run --verbose empty-activity-agp-9

create list

שימוש: android create list

תיאור: הצגת רשימה של כל התבניות הזמינות ליצירת פרויקט חדש.

describe

שימוש: android describe [--project_dir=<project-directory>]

תיאור: מנתח פרויקט Android כדי ליצור מטא-נתונים תיאוריים. הפקודה הזו מזהה את הנתיבים לקובצי JSON שמפרטים את מבנה הפרויקט, כולל יעדי ה-build והמיקומים של פריטי הפלט התואמים (לדוגמה, קובצי APK). המידע הזה מאפשר לכלים ולפקודות אחרים לאתר ביעילות את ארטיפקטים של ה-build.

אפשרויות:

  • ‫--project_dir – ספריית הפרויקט שרוצים לתאר. אם לא מציינים נתיב, נעשה שימוש בספרייה הנוכחית.

דוגמה: android describe --project_dir=/path/to/your/project

docs

שימוש:

  • android docs search <query>
  • android docs fetch <kb-url>

תיאור: הפקודה android docs היא תהליך דו-שלבי לגישה אל מאגר הידע של Android ישירות מה-CLI. קודם כל, מחפשים תיעוד שקשור לשאילתה באמצעות הפקודה search. תוצאות החיפוש יכללו כתובות URL מיוחדות שמתחילות ב-kb://, ואז תוכלו להשתמש בפקודה fetch כדי להציג את פקודות התיעוד במסוף.

לדוגמה:

  • android docs search 'How do I improve my app performance?'
  • android docs fetch kb://android/topic/performance/overview

emulator create

שימוש: android emulator create [--list-profiles] [--profile=<profile-name>]

תיאור: יצירת מכשיר וירטואלי.

אפשרויות:

  • ‫--list-profiles – הצגת רשימה של פרופילי המכשירים שאפשר להשתמש בהם כדי ליצור מכשיר.
  • ‫--profile=<profile-name> – יצירת מכשיר עם הפרופיל שצוין. אם לא מציינים את האפשרות הזו, הפרופיל ב-medium_phone ייווצר.

emulator list

שימוש: android emulator list

תיאור: רשימת המכשירים הווירטואליים הזמינים.

emulator start

שימוש: android emulator start <device-name>

תיאור: מפעילים את המכשיר הווירטואלי שצוין.

ארגומנטים (חובה):

  • ‫<device-name> – שם המכשיר להפעלה (לדוגמה, medium_phone). אפשר להשתמש ב-android emulator list כדי לראות את המכשירים הזמינים.

דוגמה: android emulator start medium_phone

emulator stop

שימוש: android emulator stop <device-serial-number>

תיאור: עצירה של המכשיר הווירטואלי שצוין.

ארגומנטים (חובה):

  • ‫<device-serial-number> – המספר הסידורי של המכשיר שרוצים להפסיק את השימוש בו.

דוגמה: android emulator stop emulator-5554

info

שימוש: android info

תיאור: הצגת הנתיב אל Android SDK שמוגדר כברירת מחדל. כדי לשנות את Android SDK שבו נעשה שימוש, צריך להשתמש ב---sdk.

init

שימוש: android init

תיאור: כדי להגדיר את הסביבה לסוכנים, צריך להתקין את מיומנות android-cli.

layout

שימוש: android layout [--pretty] [--output] [--diff]

תיאור: מחזירה את פריסת ממשק המשתמש של אפליקציית Android הפעילה (שמחוברת דרך מכשיר פיזי או אמולטור) בפורמט JSON.

אפשרויות:

  • ‫-p, --pretty – מעצב את פלט ה-JSON עם הזחה ומעברי שורה כדי שיהיה קריא לאנשים.
  • ‫-o, --output – מציין מיקום קובץ לשמירת עץ הפריסה. אם לא מציינים את האפשרות הזו, קובץ ה-JSON מודפס ישירות ל-stdout.
  • ‫-d, --diff – מחזירה רשימה של רכיבי הפריסה בלבד שהשתנו מאז הצילום האחרון של המצב הפנימי (הפעם האחרונה שבה הפריסה הופעלה), במקום את עץ הפריסה המלא.

דוגמה:: android layout --output=./hierarchy.json

run

שימוש: android run [--debug] [--activity=<activity-name>] [--device=<serial-number>] [--type=<param>] --apks=<apk-paths>

תיאור: פריסת אפליקציית Android במכשיר מחובר או באמולטור. היא לא מבצעת שלבי בנייה, אלא צריך לספק את הנתיבים לקובצי ה-APK שרוצים להתקין.

ארגומנטים (חובה):

  • ‫--apks – רשימה מופרדת בפסיקים של נתיבים לקובצי ה-APK שרוצים להתקין. הנתיב הוא יחסי למיקום הנוכחי במערכת הקבצים.

אפשרויות:

  • ‫--activity – השם של הפעילות להפעלה אחרי התקנת ה-APK. אם יש כמה פעילויות, צריך לציין פעילות אחת להפעלה הראשונית.
  • ‫--debug – פריסת האפליקציה במצב ניפוי באגים. אחרי שמריצים את האפליקציה במצב ניפוי באגים, צריך לחבר את כלי ניפוי הבאגים מ-IDE, כמו Android Studio, או מכלי שורת פקודה כדי להתחיל בניפוי הבאגים.
  • ‫--device – המספר הסידורי של מכשיר היעד או האמולטור. האפשרות הזו נחוצה רק אם מחוברים כמה מכשירים. כדי למצוא את המספרים הסידוריים של המכשירים, מריצים את הפקודה adb devices.
  • ‫--type – סוג הרכיב שרוצים להתחיל ממנו. משתמשים בזה אם רוצים להפעיל שירות הפועל ברקע ישירות במקום פעילות בממשק משתמש. סוגים נתמכים:
    • ACTIVITY
    • WATCH_FACE
    • TILE
    • COMPLICATION
    • DECLARATIVE_WATCH_FACE

לדוגמה:

  • ‫android run --apks=app/build/outputs/apk/debug/app-debug.apk – פריסה של חבילת APK אחת למכשיר ברירת המחדל.
  • ‫android run --apks=base.apk,density-hdpi.apk,lang-en.apk – פריסת כמה קובצי APK למכשיר ברירת המחדל.
  • ‫android run --apks=app-debug.apk --type=SERVICE --activity=.sync.DataSyncService – בדיקת שירות ללא פעילות.
  • ‫android run --apks=app-debug.apk --device=emulator-5554 – פריסת ה-APK במכשיר ספציפי.

screen capture

שימוש: android screen capture [--output] [--annotate]

תיאור: מצלם את המסך של המכשיר המחובר.

אפשרויות:

  • ‫-o, --output – מציין מיקום קובץ לשמירת צילום המסך. אם לא מציינים את האפשרות הזו, נתוני ה-PNG הגולמיים יודפסו ישירות ל-stdout.
  • ‫-a, --annotate – מצייר תיבות תוחמות עם תוויות סביב כל רכיבי ממשק המשתמש שזוהו בתמונה. לשימוש עם הפקודה resolve.

דוגמה: android screen capture --output=ui.png

screen resolve

שימוש: android screen resolve --screenshot=<path> --string=<string>

תיאור: מתרגם את התוויות החזותיות מצילום מסך עם הערות, שצולם באמצעות screen capture, לקואורדינטות מסך בפועל (x, y). האפשרות הזו שימושית לכתיבת סקריפטים לקליקים על רכיבים בלי לחשב ידנית את המיקומים שלהם.

דגלים:

  • ‫--screenshot – הנתיב לצילום המסך עם ההערות.
  • ‫--string – מחרוזת שכוללת לפחות placeholder אחד שמתאים לתווית של רכיב בממשק המשתמש בפורמט #<number>. החלק #<number> יוחלף בקואורדינטות של המסך.

לדוגמה:

אם התווית 5 נמצאת בקואורדינטות (500, 1000), הפקודה

android screen resolve --screenshot=ui.png --string="input tap #5"

הפלט שמתקבל

input tap 500 1000

sdk install

שימוש: android sdk install <package[@version]> [--beta] [--canary] [--force]

תיאור: התקנה של חבילות ה-SDK שצוינו.

ארגומנטים (חובה):

  • ‫package[@version] – רשימה מופרדת ברווחים של חבילות להתקנה. אם לא מציינים גרסה, מותקנת הגרסה האחרונה של החבילה בערוץ (ברירת המחדל היא הערוץ היציב).

אפשרויות:

  • ‫--beta – כולל חבילות בטא.
  • ‫--canary – כולל חבילות של גרסת גישוש.
  • ‫--force – כפיית שדרוג לאחור לגרסה ישנה יותר.

לדוגמה:

  • ‫android sdk install platforms/android-34 build-tools/34.0.0 – מתקינים את הגרסאות האחרונות של חבילות Android SDK Platform 34 ו-SDK Built Tools 34.0.0 מהערוץ היציב.
  • ‫android sdk install platforms/android-34@2 – התקנת גרסה 2 של חבילת Android SDK Platform 34.
  • ‫android sdk install --canary system-images/android-35/google_apis/x86_6 - מתקינים את הגרסה העדכנית של קובץ אימג' של המערכת Android 35 מערוץ Canary.
  • ‫android sdk install --force platforms/android-33@1 – חזרה לגרסה 1 של חבילת Android SDK Platform 33 מהערוץ היציב.

sdk list

שימוש: android sdk list <package-pattern>

תיאור: הצגת רשימה של חבילות SDK שהותקנו וחבילות SDK זמינות.

ארגומנטים (חובה):

  • ‫<package-pattern> – סינון חבילות לפי תבנית. תמיכה בביטויים רגולריים.

אפשרויות:

  • ‫--all – הצגת כל החבילות המותקנות והזמינות.
  • ‫--all-versions – הצגת כל הגרסאות של כל חבילה.
  • ‫--beta – כולל חבילות בטא.
  • ‫--canary – כולל חבילות של גרסת גישוש.

sdk remove

שימוש: android sdk remove <package-name>

תיאור: הסרת חבילה מ-SDK.

ארגומנטים (חובה):

  • ‫<package-name> – שם החבילה שרוצים להסיר.

דוגמה: android sdk remove build-tools/36.1.0

sdk update

שימוש: android sdk update [--beta] [--canary] [<package-name>]

תיאור: עדכון של חבילה אחת או של כל החבילות לגרסה האחרונה בערוץ (כברירת מחדל, הערוץ היציב). אם לא מציינים חבילה, כל החבילות יעודכנו.

אפשרויות:

  • ‫<package-name> – השם של החבילה שרוצים לעדכן.
  • ‫--beta – כולל חבילות בטא.
  • ‫--canary – כולל חבילות של גרסת גישוש.
  • ‫--force – כפיית שדרוג לאחור לגרסה ישנה יותר.

לדוגמה:

  • ‫android sdk update – בדיקה והתקנה של עדכונים לכל מה שיש ב-SDK.
  • ‫android sdk update build-tools/34.0.0 – מעדכנים את חבילת Android SDK Build Tools 34.0.0 לגרסה העדכנית ביותר בערוץ היציב.
  • ‫android sdk update --canary platforms/android-35 – מעדכנים את חבילת Android SDK Platforms 35 לגרסה האחרונה בערוץ Canary.

skills add

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

שימוש: android skills add [--all] [--agent=<agent-name>] <skill-name>

תיאור: התקנת מיומנויות של Android בספריות המיומנויות של כל הסוכנים שזוהו. אם אין לכם ספריות סוכנים קיימות ולא ציינתם סוכנים ספציפיים, המיומנויות יותקנו עבור Gemini ו-Antigravity בכתובת ~/.gemini/antigravity/skills. אם כבר התקנתם את Android skills, ‏ skills add מעדכן את ה-skills לגרסה העדכנית.

אפשרויות:

  • ‫--all – התקנה או עדכון של כל הכישורים ל-Android בבת אחת. אם לא מציינים את הפרמטר הזה (וגם לא את --skill), תותקן רק היכולת android-cli.
  • ‫--agent – רשימה מופרדת בפסיקים של סוכנים שצריך להתקין או לעדכן את המיומנות עבורם. אם לא מציינים את האפשרות הזו, המיומנות תותקן לכל הסוכנים שזוהו.
    • ‫[<skill-name>] – שם המיומנות שרוצים להתקין או לעדכן. אם לא מציינים את הפרמטר הזה (וגם לא מציינים את --all), רק מיומנות android-cli תותקן או תעודכן. דוגמה: android skills add --agent='gemini' edge-to-edge

skills find

שימוש: android skills find <string>

תיאור: חיפוש מיומנויות שתואמות למחרוזת נתונה.

ארגומנטים (חובה):

  • ‫string – מחרוזת שתואמת לתיאור של סקיל.

דוגמה: android skills find 'performance'

skills list

שימוש: android skills list [--long]

תיאור: רשימת המיומנויות הזמינות.

אפשרויות:

  • ‫--long – פלט מידע נוסף על כל מיומנות, כולל תיאור המיומנות והסוכנים שכבר הותקנה אצלם.

skills remove

שימוש: android skills remove [--agent] <skill-name>

תיאור: הסרת מיומנות. אם לא תציינו סוכנים ספציפיים, המיומנות תוסר מכל הסוכנים. ארגומנטים (חובה):

  • ‫<skill-name> – השם של המיומנות שרוצים להסיר.

אפשרויות:

  • ‫--agent - רשימה מופרדת בפסיקים של סוכנים שמהם רוצים להסיר את הכישורים. אם לא מציינים את המיומנות, היא תוסר מכל הסוכנים.

דוגמה: android skills remove --agent='gemini' --skill=edge-to-edge

studio check

הפקודות studio מאפשרות לכם או לסוכן ה-AI שלכם ליצור אינטראקציה עם מופעים פעילים של Android Studio. כשמתחברים למופע פעיל, אפשר להשתמש ביכולות של סביבת הפיתוח המשולבת כדי לנתח קבצים, למצוא הצהרות ושימושים בסמלים, להציג תצוגות מקדימות של Compose ולחפש גרסאות של יחסי תלות.

שימוש: android studio check

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

פלט לדוגמה:

אם מחובר, הפלט מציג את ה-PID של מופע Android Studio שפועל, את הגרסה ואת הסטטוס של פרויקטים פתוחים:

pid: 32942
version: Android Studio Quail
Projects:
    READY     MyApplication /Users/username/AndroidStudioProjects/MyApplication

studio analyze-file

שימוש: android studio analyze-file [--pid=<pid>] [--project=<project>] <path>

תיאור: ניתוח קובץ ב-Android Studio כדי למצוא שגיאות, אזהרות ובעיות באמצעות מנוע הבדיקה המובנה של סביבת הפיתוח המשולבת (IDE).

ארגומנטים (חובה):

  • ‫<path> – הנתיב של קובץ Kotlin או Java לניתוח.

אפשרויות:

  • ‫--pid=<pid> – מזהה ה-PID של מופע Android Studio ספציפי שאליו רוצים להתחבר, אם יש כמה מופעים.
  • ‫--project=<project> – השם של הפרויקט שפתוח ב-Android Studio שאליו מתייחסת השאילתה, אם יש כמה פרויקטים פתוחים. אם מריצים את הפקודה analyze-file מתוך ספריית פרויקט, הפרויקט הזה ישמש כברירת מחדל.

לדוגמה:

android studio analyze-file \
  --project=MyApplication \
  /Users/username/AndroidStudioProjects/MyApplication/app/src/main/java/com/example/myapp/MainActivity.kt

studio find-declaration

שימוש: android studio find-declaration [--short] [--context-file=<path>] [--pid=<pid>] [--project=<project>] <symbol>

תיאור: מוצא את האתר המדויק שבו הוגדר סמל (class, method, variable, field, constant, או Android resource) בפרויקט באמצעות semantic resolution.

ארגומנטים (חובה):

  • ‫<symbol> – השם של סמל הקוד שרוצים למצוא את ההצהרה שלו.

אפשרויות:

  • ‫--context-file=<path> – נתיב אופציונלי לקובץ שמכיל הפניה לסמל. אספקת קובץ הקשר עוזרת לפתור סמלים דו-משמעיים או עמוסים מדי על ידי אספקת ייבוא והיקף.
  • ‫--short – מפשט את הפלט כך שיוצגו רק המיקום של הקובץ והשורה התואמת.
  • ‫--pid=<pid> – מזהה ה-PID של מופע Android Studio ספציפי שאליו רוצים להתחבר, אם יש כמה מופעים.
  • ‫--project=<project> – השם של הפרויקט שפתוח ב-Android Studio שאליו מתייחסת השאילתה, אם יש כמה פרויקטים פתוחים. אם מריצים את הפקודה find-declaration מתוך ספריית פרויקט, הפרויקט הזה ישמש כברירת מחדל.

לדוגמה:

android studio find-declaration --short HotelDetailScreen

studio find-usages

שימוש: android studio find-usages [--short] [--pid=<pid>] [--project=<project>] <symbol>

תיאור: מוצא את כל ההפניות והשימושים בסמל בכל הפרויקט באמצעות ניתוח סמנטי.

ארגומנטים (חובה):

  • ‫<symbol> – השם של הסמל שרוצים למצוא את השימושים שלו.

אפשרויות:

  • ‫--short – מפשט את הפלט כך שיוצגו רק המיקומים של הקבצים התואמים.
  • ‫--pid=<pid> – מזהה ה-PID של מופע Android Studio ספציפי שאליו רוצים להתחבר, אם יש כמה מופעים.
  • ‫--project=<project> – השם של הפרויקט שפתוח ב-Android Studio שאליו מתייחסת השאילתה, אם יש כמה פרויקטים פתוחים. אם מריצים את הפקודה הזו מתוך ספריית פרויקט, הפרויקט הזה ישמש כברירת מחדל.

לדוגמה:

android studio find-usages --short HotelDetailScreen

studio open-file

שימוש: android studio open-file [--pid=<pid>] [--project=<project>] <path>

תיאור: פותח קובץ ישירות בחלון העריכה הפעיל של Android Studio.

ארגומנטים (חובה):

  • ‫<path> – הנתיב של הקובץ שרוצים לפתוח. אפשר לציין נתיב יחסי לספריית הבסיס של הפרויקט, או נתיב מוחלט.

אפשרויות:

  • ‫--pid=<pid> – מזהה ה-PID של מופע Android Studio ספציפי שאליו רוצים להתחבר, אם יש כמה מופעים.
  • ‫--project=<project> – השם של הפרויקט שפתוח ב-Android Studio שאליו מתייחסת השאילתה, אם יש כמה פרויקטים פתוחים. אם מריצים את הפקודה open-file מתוך ספריית פרויקט, הפרויקט הזה ישמש כברירת מחדל.

לדוגמה:

android studio open-file app/src/main/java/com/example/myapp/ui/DetailScreen.kt

studio render-compose-preview

שימוש: android studio render-compose-preview [--print-semantics] [--output-image-file=<filename>] [--pid=<pid>] [--project=<project>] <path> <composable>

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

ארגומנטים (חובה):

  • ‫<path> – הנתיב לקובץ Kotlin שמכיל את התצוגה המקדימה של Compose.
  • ‫<composable> – השם של פונקציית התצוגה המקדימה הקומפוזבילית (מסומנת ב-@Preview).

אפשרויות:

  • ‫--output-image-file=<filename> – מציין את שם הקובץ שאליו ייכתב קובץ ה-PNG של התמונה המעובדת. אם לא מציינים שם, נוצר קובץ זמני.
  • ‫--print-semantics – אם הערך הוא true, מודפס עץ הסמנטיקה של הנגישות בתצוגה המקדימה של הטיוטה בפורמט JSON. כך הנציגים יכולים לנתח את המבנה ואת הרכיבים האינטראקטיביים של ממשק המשתמש.
  • ‫--pid=<pid> – מזהה ה-PID של מופע Android Studio ספציפי שאליו רוצים להתחבר, אם יש כמה מופעים.
  • ‫--project=<project> – השם של הפרויקט שפתוח ב-Android Studio שאליו מתבצעת השאילתה, אם יש כמה פרויקטים פתוחים. אם מריצים את הפקודה render-compose-preview מתוך ספריית פרויקט, הפרויקט הזה ישמש כברירת מחדל.

לדוגמה:

android studio render-compose-preview \
  --output-image-file=preview_hotel.png \
  --print-semantics \
  app/src/main/java/com/example/myapp/ui/DetailScreen.kt \
  HotelDetailScreenPreview

studio version-lookup

שימוש: android studio version-lookup [--pid=<pid>] [--project=<project>] <artifacts...>

תיאור: מחפש את הגרסאות העדכניות הזמינות של תלות נפוצות, פלטפורמות Android וכלי SDK במאגרים כמו Google Maven. כך אפשר לבצע בדיקה אוטומטית של גרסאות התלות במקום בדיקה ידנית.

ארגומנטים (חובה):

  • ‫<artifacts...> – רשימה של מזהים שמופרדים באמצעות רווחים. אפשר להריץ שאילתה על כמה ארטיפקטים בפקודה אחת. המזהים הנתמכים כוללים:
    • ספריות Maven: הסימון groupId:artifactId (לדוגמה, androidx.window:window).
    • פלאגינים של Gradle: מזהה הפלאגין (לדוגמה, com.android.application).
    • מילות מפתח:
      • ‫gradle (Gradle build tool)
      • ‫studio (Android Studio)
      • ‫agp (פלאגין של Android Gradle)
      • ‫ndk (Android NDK)
      • ‫sdk (Android SDK)
      • ‫emulator (אמולטור Android)
      • ‫adb (ממשק הגישור של Android‏ (ADB‏)‎)
      • ‫compose (Jetpack Compose BOM)
      • ‫kotlin (Kotlin runtime and compiler)
      • ‫android (גרסאות של Android OS)
      • ‫platform-tools (Android SDK Platform-Tools)
      • ‫cmdline-tools (Android SDK Command-line Tools)
      • ‫build-tools (Android SDK Build-Tools)

אפשרויות:

  • ‫--pid=<pid> – מזהה ה-PID של מופע Android Studio ספציפי שאליו רוצים להתחבר, אם יש כמה מופעים.
  • ‫--project=<project> – השם של הפרויקט שפתוח ב-Android Studio שאליו מתייחסת השאילתה, אם יש כמה פרויקטים פתוחים. אם מריצים את הפקודה version-lookup מתוך ספריית פרויקט, הפרויקט הזה ישמש כברירת מחדל.

לדוגמה:

android studio version-lookup \
  androidx.compose.ui:ui \
  com.android.application \
  agp \
  kotlin

update

שימוש: android update

תיאור: עדכון של Android CLI.

-V, --version

תיאור: הצגת הגרסה הנוכחית של Android CLI.