پشتیبانی از Rust در ASfP

نمای کلی

Rust یک زبان برنامه نویسی سیستم های مدرن است که بر عملکرد و ایمنی، به ویژه ایمنی حافظه تمرکز دارد. زنگ به طور فزاینده ای در اکوسیستم اندروید به عنوان جایگزین ایمن تری برای C/C++ برای توسعه اجزای حیاتی سیستم که امنیت و پایداری بهتری ارائه می دهد، اهمیت دارد.

این صفحه شما را از طریق راه‌اندازی Android Studio برای پلتفرم (ASfP) برای پشتیبانی از توسعه Rust در پروژه‌های Android Open Source Project (AOSP) شما راهنمایی می‌کند.

پیش نیازها

  • ASfP نصب شده: بررسی کنید که ASfP را نصب و اجرا کرده اید.
  • تسویه حساب پلت فرم: شما به یک پرداخت پلت فرم AOSP در دستگاه خود نیاز دارید.

فعال کردن پشتیبانی Rust

در اینجا روند گام به گام برای دریافت پشتیبانی Rust در پروژه ASfP شما آمده است:

  1. 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-project.json تولید شده است.
  • شما باید ویژگی های Rust را فعال کنید (که در زیر توضیح داده شده و نشان داده شده است) در IDE خود فعال شده است.

ویژگی های کلید Rust IDE

  • تکمیل کد: پیشنهادات هوشمندانه ای برای کد Rust، از جمله مواردی از ماژول های دیگر دریافت کنید.

    نمونه تکمیل کد متقابل ماژول Rust
    تکمیل کد مواردی را از یک ماژول Rust دیگر پیشنهاد می کند.

  • پیمایش: به سرعت به تعاریف بروید و موارد استفاده از نمادهای Rust را در پروژه خود بیابید.

    نمونه ناوبری کد زنگ
    پیمایش به تعریف نماد زنگ.
    مثال استفاده از Rust find
    یافتن تمام موارد استفاده از نماد زنگ.

  • نکات ابزار: نشانگر را روی نمادها نگه دارید تا اطلاعات نوع و اسناد را ببینید.

    Rust tooltip مثال
    راهنمای ابزار که اطلاعات نوع نماد Rust را از ماژول دیگری نشان می دهد.

  • نکات Inlay: اطلاعات نوع و سایر نکات متنی را مستقیماً در ویرایشگر مشاهده کنید.

    نمونه نکات خاتم زنگ زده
    نکات Inlay اطلاعات نوع را در کد نشان می دهد.

  • نمای ساختار: ساختار فایل های Rust خود را با استفاده از پنجره ابزار Structure (View > Tool Windows > Structure) پیمایش کنید.

    نمونه نمای ساختار زنگ
    پنجره ابزار ساختار که طرح کلی یک فایل Rust را نشان می دهد.

  • Refactoring: نام نمادها را با خیال راحت تغییر دهید و همه موارد استفاده را به روز کنید.

    نمونه بازسازی نماد زنگ تغییر نام
    تغییر نام نماد Rust و به روز رسانی تمام مراجع آن.

  • تجزیه و تحلیل بلادرنگ: در مورد خطاها و هشدارها در کد Rust خود بازخورد فوری دریافت کنید.

    نمونه تجزیه و تحلیل کد بلادرنگ Rust
    IDE خطاها و هشدارهای بلادرنگ را در کد Rust نشان می دهد.