תמיכה ב-Rust ב-ASfP

סקירה כללית

‫Rust היא שפת תכנות מודרנית למערכות שמתמקדת בביצועים ובבטיחות, במיוחד בבטיחות הזיכרון. השימוש ב-Rust הופך לחשוב יותר ויותר במערכת האקולוגית של Android, כחלופה בטוחה יותר ל-C/C++‎ לפיתוח רכיבי מערכת קריטיים, והוא מציע אבטחה ויציבות משופרות.

בדף הזה מוסבר איך להגדיר את Android Studio for Platform ‏ (ASfP) כדי לתמוך בפיתוח Rust בפרויקטים של פרויקט קוד פתוח של Android ‏ (AOSP).

דרישות מוקדמות

• ASfP Installed: מוודאים ש-ASfP מותקן ופועל.
• תשלום בפלטפורמה: צריך תשלום פעיל בפלטפורמת AOSP במחשב.

הפעלת תמיכה ב-Rust

כך מגדירים תמיכה ב-Rust בפרויקט ASfP:

1. הפעלת Rust

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

   

   תיבת הסימון Rust באשף ההגדרה של פרויקט חדש.

   • בפרויקטים קיימים, עוברים להגדרה .asfp-project ומוסיפים את rust ל-other_languages:

       other_languages:
         -   cpp
         -   rust
       ```
   
   <figure>
         <img src="/studio/platform/images/1-modify_asfp_project_languages.png" alt="Modifying the .asfp-project file to add rust to other_languages" class="screenshot">
         <figcaption>Adding Rust support in the <code>.asfp-project</code> file.</figcaption>
       </figure>
   

1. סנכרון הפרויקט:

   • אחרי שמבצעים את השלבים הקודמים, צריך להפעיל סנכרון של הפרויקט כדי לוודא שכל השינויים יוחלו וסביבת הפיתוח המשולבת (IDE) תזהה את פרויקט Rust: עוברים אל File > Sync Project (קובץ > סנכרון הפרויקט).

אימות ההצלחה

אחרי שמבצעים את השלבים האלה:

• הסמל rust-project.json אמור להופיע בתצוגת הפרויקט (בקטע של מקור ה-iml). הקובץ הזה נוצר על ידי Soong במהלך הניתוח ומקושר באמצעות קישור סמלי אל ספריית הבסיס של repo, שנדרשת כדי ש-LSP יוכל לספק שירותי שפה. אין לערוך את הקובץ הזה ישירות. במקום זאת, צריך לסנכרן מחדש כדי ש-Soong יטפל בו.

  להזכירך, כדאי לוודא שהערך rust מופיע בקטע other_languages בהגדרות של .asfp-project.

  

  מוודאים שנוצר rust-project.json.

• תכונות ספציפיות ל-Rust (שמתוארות ומוצגות בהמשך) אמורות להיות מופעלות בסביבת הפיתוח המשולבת.

תכונות מרכזיות של סביבת פיתוח משולבת (IDE) של Rust

• השלמת קוד: קבלת הצעות חכמות לקוד Rust, כולל פריטים ממודולים אחרים.

  

  השלמת קוד שמציעה פריטים ממודול Rust אחר.

• ניווט: מעבר מהיר להגדרות וחיפוש של שימושים בסמלי Rust בפרויקט.

  

  ניווט להגדרה של סמל Rust.

  

  חיפוש כל המקומות שבהם נעשה שימוש בסמל Rust.

• הסברים קצרים: מצביעים על סמלים כדי לראות מידע על הסוג ותיעוד.

  

  הסבר קצר שמציג מידע על סוג של סמל Rust ממודול אחר.

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

  

  רמזים מוטבעים שמציגים מידע על סוג בתוך הקוד.

• תצוגת המבנה: אפשר לנווט במבנה של קובצי Rust באמצעות חלון הכלים Structure (מבנה) (View > Tool Windows > Structure (תצוגה > חלונות כלים > מבנה)).

  

  חלון הכלים של המבנה שבו מוצג המתאר של קובץ Rust.

• שינוי מבנה הקוד: שינוי בטוח של שמות הסמלים ועדכון כל השימושים.

  

  שינוי השם של סמל Rust ועדכון כל ההפניות אליו.

• ניתוח בזמן אמת: מקבלים משוב מיידי על שגיאות ואזהרות בקוד Rust.

  

  IDE שמציג שגיאות ואזהרות בזמן אמת בקוד Rust.