پیکربندی واحد برنامه

این صفحه تنظیمات مفید برنامه را در فایل build.gradle.kts در سطح ماژول شرح می‌دهد. علاوه‌بر ارائه نمای کلی از ویژگی‌های مهم تنظیم‌شده در فایل build.gradle.kts، با نحوه انجام کارهای زیر آشنا شوید:

  • شناسه برنامه را برای پیکربندی‌های مختلف ساخت تغییر دهید.
  • فضای نام را به‌طور ایمن و مستقل از شناسه برنامه تنظیم کنید.

تنظیم شناسه برنامه

هر برنامه Android دارای شناسه برنامه یکتایی است که شبیه نام بسته Java یا Kotlin است، مثل com.example.myapp. این شناسه به‌طور منحصربه‌فرد برنامه شما را در دستگاه و در «فروشگاه Google Play» شناسایی می‌کند.

شناسه برنامه شما توسط ویژگی applicationId در فایل build.gradle.kts واحد شما تعریف می‌شود، همان‌طور که در اینجا نشان داده شده است. مقدار applicationId را با جایگزین کردن com.example.myapp با شناسه برنامه‌تان به‌روز کنید:

کاتلین

android {
    defaultConfig {
        applicationId = "com.example.myapp"
        minSdk = 15
        targetSdk = 24
        versionCode = 1
        versionName = "1.0"
    }
    ...
}

شیک

android {
    defaultConfig {
        applicationId "com.example.myapp"
        minSdkVersion 15
        targetSdkVersion 24
        versionCode 1
        versionName "1.0"
    }
    ...
}

اگرچه شناسه برنامه شبیه نام بسته سنتی Kotlin یا Java است، قوانین نام‌گذاری برای شناسه برنامه کمی محدودکننده‌تر است:

  • باید حداقل دو بخش داشته باشد (یک یا چند نقطه).
  • هر بخش باید با حرف شروع شود.
  • همه نویسه‌ها باید الفباعددی یا زیرخط [a-zA-Z0-9_] باشند.

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

توصیه می‌شود هنگام تنظیم شناسه برنامه، موارد زیر را انجام دهید:

  • شناسه برنامه را با جای نام یکسان نگه دارید. تمایز بین این دو ویژگی می‌تواند کمی گیج‌کننده باشد، اما اگر آن‌ها را یکسان نگه دارید، جای نگرانی نیست.
  • پس‌از انتشار برنامه، شناسه برنامه را تغییر ندهید. اگر آن را تغییر دهید، «فروشگاه Google Play» بارگذاری بعدی را به‌عنوان برنامه‌ای جدید درنظر می‌گیرد.
  • شناسه برنامه را به‌طور صریح تعریف کنید. اگر شناسه برنامه به‌طور صریح بااستفاده از ویژگی applicationId تعریف نشده باشد، به‌طور خودکار همان مقدار فضای نام را می‌گیرد. این یعنی تغییر فضای نام باعث تغییر شناسه برنامه می‌شود که معمولاً چیزی نیست که بخواهید.

تغییر شناسه برنامه برای آزمایش

به‌طور پیش‌فرض، ابزارهای ساخت شناسه برنامه‌ای را به APK آزمایش ابزار دقیق شما اعمال می‌کنند که از شناسه برنامه برای تنوع ساخت داده‌شده استفاده می‌کند و .test به آن اضافه شده است. برای مثال، یک APK آزمایشی برای تنوع ساخت com.example.myapp.free دارای شناسه برنامه com.example.myapp.free.test است.

اگرچه نباید ضروری باشد، می‌توانید شناسه برنامه را با تعریف کردن ویژگی testApplicationId در بلوک defaultConfig یا productFlavor تغییر دهید.

تنظیم فضای نام

هر ماژول Android یک فضای نام دارد که به‌عنوان نام بسته Kotlin یا Java برای کلاس‌های R و BuildConfig تولیدشده آن استفاده می‌شود.

فضای نام شما با ویژگی namespace در فایل build.gradle.kts واحدتان تعریف می‌شود، همان‌طور که در تکه‌کد زیر نشان داده شده است. namespace در ابتدا روی نام بسته‌ای تنظیم می‌شود که هنگام ایجاد پروژه انتخاب می‌کنید.

کاتلین

android {
    namespace = "com.example.myapp"
    ...
}

شیک

android {
    namespace "com.example.myapp"
    ...
}

هنگام ساختن برنامه در بسته برنامه نهایی (APK)، ابزارهای ساخت Android از فضای نام به‌عنوان فضای نام برای کلاس R تولیدشده برنامه‌تان استفاده می‌کنند که برای دسترسی به منابع برنامه استفاده می‌شود. برای مثال، در فایل ساخت قبلی، کلاس R در com.example.myapp.R ایجاد شده است.

نامی که برای ویژگی namespace فایل build.gradle.kts تنظیم می‌کنید باید همیشه با نام بسته پایه پروژه‌تان مطابقت داشته باشد، جایی که فعالیت‌ها و دیگر کدهای برنامه‌تان را نگه می‌دارید. می‌توانید زیربسته‌های دیگری در پروژه‌تان داشته باشید، اما آن فایل‌ها باید کلاس R را بااستفاده از فضای نام از ویژگی namespace وارد کنند.

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

تغییر فضای نام

در بیشتر موارد، باید فضای نام و شناسه برنامه را یکسان نگه دارید، همان‌طور که به‌طور پیش‌فرض هستند. اما اگر درحال سازمان‌دهی مجدد کدتان هستید یا برای جلوگیری از تداخل فضای نام، ممکن است لازم باشد فضای نام را در نقطه‌ای تغییر دهید.

در این موارد، فضای نام را با به‌روزرسانی ویژگی namespace در فایل build.gradle.kts واحدتان مستقل از شناسه برنامه تغییر دهید. قبل‌از انجام این کار، مطمئن شوید که شناسه برنامه شما به‌طور صریح تعریف شده است تا تغییر فضای نام باعث تغییر شناسه برنامه نشود. برای اطلاعات بیشتر درباره اینکه فضای نام چگونه می‌تواند بر شناسه برنامه تأثیر بگذارد، به تنظیم شناسه برنامه مراجعه کنید.

اگر نام‌های متفاوتی برای namespace و Gradle applicationId دارید، ابزارهای ساخت شناسه برنامه را در پایان ساخت در فایل مانیفست نهایی برنامه‌تان کپی می‌کنند. بنابراین اگر فایل AndroidManifest.xml را پس‌از ساخت بررسی کنید، ویژگی package روی شناسه برنامه تنظیم شده است. ویژگی package مانیفست ادغام‌شده جایی است که «فروشگاه Google Play» و پلاتفرم Android درواقع برای شناسایی برنامه‌تان به آن نگاه می‌کنند.

تغییر فضای نام برای آزمایش کردن

جای‌نام پیش‌فرض برای مجموعه‌های منبع androidTest و test جای‌نام اصلی است که .test به انتهای آن اضافه شده است. برای مثال، اگر ویژگی namespace در فایل build.gradle برابر با com.example.myapp باشد، فضای نام آزمایشی به‌طور پیش‌فرض روی com.example.myapp.test تنظیم می‌شود. برای تغییر فضای نام برای آزمایش، از ویژگی testNamespace استفاده کنید، همان‌طور که در تکه‌کد زیر نشان داده شده است:

کاتلین

android {
    namespace = "com.example.myapp"
    testNamespace = "com.example.mytestapp"
    ...
}

شیک

android {
    namespace "com.example.myapp"
    testNamespace "com.example.mytestapp"
    ...
}

برای کسب اطلاعات بیشتر درباره آزمایش، به آزمایش کردن برنامه‌ها در Android مراجعه کنید.