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

نمای کلی

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

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

پیش‌نیازها

  • نصب ASfP: تأیید کنید که 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 root) لینک شده است، که برای ارائه خدمات زبان توسط LSP ضروری است. این فایل را مستقیماً ویرایش نکنید . در عوض، آن را دوباره همگام‌سازی کنید تا Soong آن را مدیریت کند.

    به عنوان یادآوری، دوباره بررسی کنید که آیا rust در فایل پیکربندی .asfp-project شما در زیر other_languages ​​وجود دارد یا خیر.

    مطمئن شوید که فایل rust-project.json ایجاد شده است.
    مطمئن شوید که rust-project.json ایجاد شده است.

  • شما باید ویژگی‌های خاص Rust (که در زیر توضیح داده شده و نشان داده شده‌اند) را در IDE خود فعال شده ببینید.

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

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

    مثال تکمیل کد بین ماژول‌های Rust
    تکمیل کد، مواردی را از یک ماژول Rust متفاوت پیشنهاد می‌دهد.

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

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

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

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

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

    مثالی از نکات مربوط به منبت‌کاری زنگ‌زدگی
    نکات درج‌شده که اطلاعات نوع را درون کد نشان می‌دهند.

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

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

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

    مثال تغییر نام نماد Rust
    تغییر نام یک نماد Rust و به‌روزرسانی تمام ارجاعات آن.

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

    مثال تحلیل کد در زمان واقعی Rust
    IDE که خطاها و هشدارها را در کد Rust به صورت بلادرنگ نشان می‌دهد.