به اندروید استودیو مهاجرت کنید

انتقال پروژه های خود به Android Studio مستلزم انطباق با ساختار پروژه جدید، سیستم ساخت و عملکرد IDE است.

اگر از IntelliJ مهاجرت می کنید و پروژه شما قبلاً از Gradle استفاده می کند، می توانید پروژه موجود خود را از Android Studio باز کنید. اگر از IntelliJ استفاده می‌کنید اما پروژه شما قبلاً از Gradle استفاده نمی‌کند، قبل از اینکه بتوانید آن را به Android Studio وارد کنید، باید پروژه خود را به صورت دستی آماده کنید. برای اطلاعات بیشتر، به بخش مهاجرت از IntelliJ مراجعه کنید.

اصول اولیه اندروید استودیو

در اینجا برخی از تفاوت های کلیدی وجود دارد که هنگام آماده شدن برای مهاجرت به Android Studio باید از آنها آگاه باشید.

سازمان پروژه و ماژول

اندروید استودیو مبتنی بر IntelliJ IDEA IDE است. برای آشنایی با اصول اولیه IDE، مانند پیمایش، تکمیل کد و میانبرهای صفحه کلید، به Meet Android Studio مراجعه کنید.

Android Studio کدها را در پروژه‌هایی سازماندهی می‌کند که شامل هر چیزی است که برنامه اندروید شما را تعریف می‌کند، از کد منبع برنامه گرفته تا ساخت پیکربندی‌ها و کد آزمایشی. پروژه ها در پنجره های جداگانه Android Studio باز می شوند. هر پروژه شامل یک یا چند ماژول است که به شما امکان می دهد پروژه خود را به واحدهای عملکردی مجزا تقسیم کنید. ماژول ها را می توان به طور مستقل ساخت، آزمایش و اشکال زدایی کرد.

برای اطلاعات بیشتر درباره پروژه‌ها و ماژول‌های Android Studio، به نمای کلی پروژه‌ها مراجعه کنید.

سیستم ساخت مبتنی بر Gradle

سیستم ساخت اندروید استودیو مبتنی بر Gradle است و از فایل‌های پیکربندی ساخت که با اسکریپت Groovy یا Kotlin نوشته شده‌اند برای سهولت توسعه‌پذیری و سفارشی‌سازی استفاده می‌کند.

پروژه های مبتنی بر Gradle ویژگی های قابل توجهی را برای توسعه اندروید ارائه می دهند، از جمله موارد زیر:

  • پشتیبانی از کتابخانه های باینری (AARs). دیگر نیازی به کپی کردن منابع کتابخانه در پروژه های خود ندارید. شما می توانید یک وابستگی را اعلام کنید و کتابخانه به طور خودکار دانلود و در پروژه شما ادغام می شود. این شامل ادغام خودکار در منابع، ورودی های مانیفست، قوانین حذف Proguard، قوانین پرز سفارشی و غیره در زمان ساخت است.
  • پشتیبانی از انواع ساخت ، که به شما امکان می دهد نسخه های مختلف برنامه خود را (مانند نسخه رایگان و نسخه حرفه ای) از یک پروژه بسازید.
  • پیکربندی و سفارشی سازی آسان ساخت . به عنوان مثال، می‌توانید نام نسخه و کد نسخه را از تگ‌های Git به عنوان بخشی از بیلد بیرون بکشید.
  • Gradle را می توان از IDE، از خط فرمان ، و از سرورهای یکپارچه سازی پیوسته مانند Jenkins استفاده کرد، و در همه جا و هر زمان یک ساخت را ارائه می دهد.

برای اطلاعات بیشتر در مورد استفاده و پیکربندی Gradle، به پیکربندی ساخت خود مراجعه کنید.

وابستگی ها

وابستگی‌های کتابخانه در Android Studio از اعلان‌های وابستگی Gradle و وابستگی‌های Maven برای منبع محلی معروف و کتابخانه‌های باینری با مختصات Maven استفاده می‌کنند. برای اطلاعات بیشتر، به اعلام وابستگی ها مراجعه کنید.

مهاجرت از IntelliJ

اگر پروژه IntelliJ شما از سیستم ساخت Gradle استفاده می کند، می توانید پروژه خود را مستقیماً به Android Studio وارد کنید. اگر پروژه IntelliJ شما از Maven یا سیستم ساخت دیگری استفاده می‌کند، باید آن را برای کار با Gradle تنظیم کنید تا بتوانید به Android Studio مهاجرت کنید.

یک پروژه IntelliJ مبتنی بر Gradle را وارد کنید

اگر قبلاً از Gradle با پروژه IntelliJ خود استفاده می کنید، با استفاده از مراحل زیر آن را در Android Studio باز کنید:

  1. روی File > New > Import Project کلیک کنید.
  2. دایرکتوری پروژه IntelliJ خود را انتخاب کرده و روی OK کلیک کنید. پروژه شما در Android Studio باز می شود.

یک پروژه IntelliJ غیر Gradle را وارد کنید

اگر پروژه IntelliJ شما قبلاً از سیستم ساخت Gradle استفاده نمی کند، دو گزینه برای وارد کردن پروژه خود به Android Studio دارید که در بخش های زیر توضیح داده شده است:

با ایجاد یک پروژه خالی جدید مهاجرت کنید

برای انتقال پروژه خود به اندروید استودیو با ایجاد یک پروژه خالی جدید و کپی کردن فایل های منبع خود در فهرست های جدید، به صورت زیر عمل کنید:

  1. Android Studio را باز کنید و روی File > New > New Project کلیک کنید.
  2. یک نام برای پروژه برنامه خود وارد کنید و مکانی را که باید در آن ایجاد شود را مشخص کنید، سپس روی Next کلیک کنید.
  3. فاکتورهای فرمی را که برنامه شما روی آنها اجرا می شود انتخاب کنید، سپس روی Next کلیک کنید.
  4. روی Add No Activity کلیک کنید، سپس روی Finish کلیک کنید.
  5. در پنجره ابزار Project ، روی فلش کلیک کنید تا منوی view باز شود و نمای پروژه را انتخاب کنید تا سازمان پروژه Android Studio جدید خود را ببینید و کاوش کنید. برای اطلاعات بیشتر در مورد تغییر نماها و نحوه ساختاربندی پروژه‌ها در Android Studio، به فایل‌های پروژه مراجعه کنید.
  6. به مکانی که برای پروژه جدید خود انتخاب کرده اید بروید و کد، تست های واحد، تست های ابزار دقیق و منابع را از دایرکتوری های پروژه قدیمی خود به مکان های صحیح در ساختار پروژه جدید خود منتقل کنید.
  7. در Android Studio، روی File > Project Structure کلیک کنید تا کادر گفتگوی Project Structure باز شود. مطمئن شوید که ماژول برنامه شما در قسمت سمت چپ انتخاب شده است.
  8. هر گونه اصلاح لازم را در تب Properties برای پروژه خود انجام دهید (به عنوان مثال، اصلاح minSdk یا targetSdk ).
  9. روی Dependencies کلیک کنید و هر کتابخانه ای را که پروژه شما به آن وابسته است را به عنوان وابستگی Gradle اضافه کنید. برای افزودن یک وابستگی جدید، روی افزودن کلیک کنید ، سپس نوع وابستگی را که می خواهید اضافه کنید انتخاب کنید و دستورات را دنبال کنید.
  10. برای ذخیره تغییرات خود روی OK کلیک کنید.
  11. برای آزمایش ساختن پروژه خود، روی ساخت > ساخت پروژه کلیک کنید و در صورت لزوم خطاهای باقی مانده را برطرف کنید.

با ایجاد یک فایل ساخت سفارشی Gradle مهاجرت کنید

برای انتقال پروژه خود به اندروید استودیو با ایجاد یک فایل بیلد جدید Gradle برای اشاره به فایل های منبع موجود، به صورت زیر عمل کنید:

  1. قبل از شروع، از فایل های پروژه خود در یک مکان جداگانه نسخه پشتیبان تهیه کنید، زیرا فرآیند مهاجرت محتوای پروژه شما را در جای خود تغییر می دهد.
  2. اگر از Groovy یا build.gradle.kts استفاده می کنید، اگر از اسکریپت Kotlin استفاده می کنید، یک فایل در فهرست پروژه خود به نام build.gradle ایجاد کنید. این فایل حاوی تمام اطلاعات مورد نیاز Gradle برای اجرای بیلد شما می باشد.

    به طور پیش‌فرض، Android Studio انتظار دارد که پروژه شما مطابق شکل 1 سازماندهی شود.

    شکل 1. ساختار پروژه پیش فرض برای یک ماژول برنامه اندروید.

    در settings.gradle ، برای Groovy، یا settings.gradle.kts ، برای اسکریپت Kotlin، مخازنی را تنظیم می کنید که برای یافتن افزونه ها و وابستگی ها در بلوک های pluginManagement و dependencyResolutionManagement استفاده می شوند:

    شیار

      pluginManagement {
      repositories {
          google()
          mavenCentral()
          gradlePluginPortal()
      }
  }
  dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
          google()
          mavenCentral()
      }
  }
  rootProject.name = "Test App"
  include ':app'

    کاتلین

      pluginManagement {
      repositories {
          google()
          mavenCentral()
          gradlePluginPortal()
      }
  }
  dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
          google()
          mavenCentral()
      }
  }
  rootProject.name = "Test App"
  include(":app")

    هشدار: مخزن JCenter در 31 مارس 2021 فقط خواندنی شد. برای اطلاعات بیشتر، به‌روزرسانی سرویس JCenter را ببینید.

    افزونه Android Gradle برخی از مجموعه های منبع پیش فرض را برای پروژه اعمال می کند. این مجموعه های منبع دایرکتوری های مورد استفاده برای ذخیره انواع مختلف فایل های منبع را تعریف می کنند. Gradle از این مجموعه های منبع برای تعیین مکان انواع فایل های خاص استفاده می کند. اگر پروژه موجود شما با پیش‌فرض‌ها مطابقت ندارد، می‌توانید فایل‌ها را به جایی که باید باشند منتقل کنید یا مجموعه‌های منبع پیش‌فرض را تغییر دهید تا Gradle بداند کجا آنها را پیدا کند.

    برای اطلاعات بیشتر در مورد تنظیم و سفارشی کردن یک فایل ساخت Gradle، پیکربندی ساخت خود را بخوانید.

  3. بعد، مشخص کنید که از کدام پروژه های کتابخانه ای استفاده می کنید.

    با Gradle، دیگر نیازی به اضافه کردن این کتابخانه ها به عنوان پروژه های کد منبع ندارید. در عوض می‌توانید به آنها در بلوک dependencies{} فایل ساخت خود مراجعه کنید. سپس سیستم ساخت این کتابخانه ها را برای شما مدیریت می کند، از جمله دانلود کتابخانه ها، ادغام در منابع و ادغام ورودی های مانیفست. مثال زیر دستورهای اعلامیه تعدادی از کتابخانه های AndroidX را به بلوک dependencies{} یک فایل ساخت اضافه می کند.

    شیار

    ...
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])

    // AndroidX libraries
    implementation 'androidx.core:core-ktx:1.13.1'
    implementation 'androidx.appcompat:appcompat:1.7.0'
    implementation 'androidx.cardview:cardview:1.0.0'
    implementation 'com.google.android.material:material:1.7.0'
    implementation 'androidx.gridlayout:gridlayout:1.0.0'
    implementation 'androidx.leanback:leanback:1.1.0-rc02'
    implementation 'androidx.mediarouter:mediarouter:1.7.0'
    implementation 'androidx.palette:palette-ktx:1.0.0'
    implementation 'androidx.recyclerview:recyclerview:1.3.2'
    implementation 'androidx.annotation:annotation:1.8.1'

    // Note: these libraries require that the Google repository has been declared
    // in the pluginManagement section of the top-level build.gradle file.
}

    کاتلین

    ...
dependencies {
    implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar"))))

    // AndroidX libraries
    implementation("androidx.core:core-ktx:1.13.1")
    implementation("androidx.appcompat:appcompat:1.7.0")
    implementation("androidx.cardview:cardview:1.0.0")
    implementation("com.google.android.material:material:1.7.0")
    implementation("androidx.gridlayout:gridlayout:1.0.0")
    implementation("androidx.leanback:leanback:1.1.0-rc02")
    implementation("androidx.mediarouter:mediarouter:1.7.0")
    implementation("androidx.palette:palette-ktx:1.0.0")
    implementation("androidx.recyclerview:recyclerview:1.3.2")
    implementation("androidx.annotation:annotation:1.8.1")

    // Note: these libraries require that the Google repository has been declared
    // in the pluginManagement section of the top-level build.gradle.kts file.
}
    برای کمک به تعیین بیانیه های صحیح برای کتابخانه های خود، مخزن Google Maven یا Maven Central را جستجو کنید.
  4. فایل build.gradle خود را ذخیره کنید، سپس پروژه را در IntelliJ ببندید. به دایرکتوری پروژه خود بروید و دایرکتوری .idea و هر فایل IML موجود در پروژه خود را حذف کنید.
  5. Android Studio را اجرا کنید و روی File > New > Import Project کلیک کنید.
  6. دایرکتوری پروژه خود را پیدا کنید، فایل build.gradle یا build.gradle.kts را که ایجاد کرده اید انتخاب کنید و سپس روی OK کلیک کنید تا پروژه شما وارد شود.
  7. روی Build > Make Project کلیک کنید تا فایل ساخت خود را با ساختن پروژه خود آزمایش کنید و هر خطایی را که پیدا کردید برطرف کنید.

مراحل بعدی

هنگامی که پروژه خود را به Android Studio منتقل کردید، با خواندن Build و اجرای برنامه خود، درباره ساخت با Gradle و اجرای برنامه خود در Android Studio اطلاعات بیشتری کسب کنید.

بسته به پروژه و گردش کار خود، ممکن است بخواهید درباره کنترل نسخه، مدیریت وابستگی ها و پیکربندی Android Studio اطلاعات بیشتری کسب کنید. برای شروع استفاده از Android Studio، Meet Android Studio را بخوانید.

پیکربندی کنترل نسخه

Android Studio از انواع سیستم های کنترل نسخه از جمله Git، Mercurial و Subversion پشتیبانی می کند. سایر سیستم های کنترل نسخه را می توان از طریق افزونه ها اضافه کرد.

اگر برنامه شما قبلاً تحت کنترل منبع است، ممکن است لازم باشد آن را در Android Studio فعال کنید. از منوی VCS، روی Enable Version Control Integration کلیک کنید و سیستم کنترل نسخه مناسب را انتخاب کنید.

اگر برنامه شما تحت کنترل منبع نیست، می توانید پس از وارد کردن برنامه خود به Android Studio، آن را پیکربندی کنید. از گزینه های منوی Android Studio VCS برای فعال کردن پشتیبانی VCS برای سیستم کنترل نسخه مورد نظر، ایجاد یک مخزن، وارد کردن فایل های جدید به کنترل نسخه و انجام سایر عملیات کنترل نسخه استفاده کنید:

  1. از منوی Android Studio VCS، روی Enable Version Control Integration کلیک کنید.
  2. یک سیستم کنترل نسخه را برای مرتبط کردن با ریشه پروژه از منو انتخاب کنید، سپس روی OK کلیک کنید. منوی VCS اکنون تعدادی از گزینه های کنترل نسخه را بر اساس سیستمی که انتخاب کرده اید نمایش می دهد.

توجه: همچنین می توانید از گزینه منوی File > Settings > Version Control برای تنظیم و تغییر کنترل نسخه استفاده کنید.

برای اطلاعات بیشتر در مورد کار با کنترل نسخه، به مرجع کنترل نسخه IntelliJ مراجعه کنید.

امضای برنامه

اگر قبلاً از گواهی اشکال زدایی استفاده شده باشد، ممکن است در طی فرآیند واردات شناسایی شود. در این مورد، اندروید استودیو همچنان به آن گواهی اشاره می کند. در غیر این صورت، پیکربندی اشکال‌زدایی از ذخیره‌سازی کلیدهای اشکال‌زدایی ایجاد شده توسط Android Studio استفاده می‌کند، با استفاده از یک رمز عبور شناخته‌شده و یک کلید پیش‌فرض با رمز عبور شناخته‌شده واقع در $HOME/.android/debug.keystore . نوع ساخت اشکال‌زدایی تنظیم شده است تا وقتی پروژه خود را از Android Studio اجرا یا اشکال‌زدایی می‌کنید، از این پیکربندی اشکال‌زدایی به‌طور خودکار استفاده کند.

به طور مشابه، فرآیند واردات ممکن است گواهی انتشار موجود را شناسایی کند. اگر قبلاً گواهی انتشار تعریف نشده بود، پیکربندی امضای انتشار را به فایل build.gradle یا build.gradle.kts اضافه کنید یا از گزینه منوی Build > Generate Signed APK برای باز کردن Generate Signed APK Wizard استفاده کنید. برای اطلاعات بیشتر درباره امضای برنامه خود، به امضای برنامه خود مراجعه کنید.

حداکثر اندازه پشته Android Studio را تنظیم کنید

به طور پیش‌فرض، Android Studio دارای حداکثر اندازه هپ 1280 مگابایت است. اگر روی یک پروژه بزرگ کار می کنید، یا سیستم شما رم زیادی دارد، می توانید با افزایش حداکثر اندازه پشته عملکرد را بهبود ببخشید.

بروز رسانی نرم افزار

اندروید استودیو جدا از پلاگین Gradle، ابزارهای ساخت و ابزارهای SDK به روز رسانی می شود. می‌توانید مشخص کنید که از کدام نسخه‌ها می‌خواهید با Android Studio استفاده کنید.

به‌طور پیش‌فرض، Android Studio هر زمان که نسخه پایدار جدیدی منتشر می‌شود، به‌روزرسانی‌های خودکار را ارائه می‌کند، اما می‌توانید به‌روزرسانی‌های بیشتری را انتخاب کنید و نسخه‌های پیش‌نمایش یا بتا را دریافت کنید.

برای اطلاعات بیشتر درباره به‌روزرسانی Android Studio و استفاده از نسخه‌های پیش‌نمایش و بتا، درباره به‌روزرسانی‌ها بخوانید.