پیکربندی ارسال شرطی

ارسال مشروط به شما امکان می‌دهد الزامات پیکربندی دستگاه خاصی را برای بارگیری خودکار پیمانه‌های ویژگی درطول نصب برنامه تنظیم کنید. برای مثال، می‌توانید یک پیمانه ویژگی پیکربندی کنید که شامل عملکرد واقعیت افزوده (AR) باشد تا هنگام نصب برنامه فقط برای دستگاه‌هایی که از AR پشتیبانی می‌کنند دردسترس باشد.

این سازوکار تحویل درحال‌حاضر از کنترل بارگیری مدول در زمان نصب برنامه براساس پیکربندی‌های دستگاه زیر پشتیبانی می‌کند:

اگر دستگاهی همه شرایطی را که مشخص کرده‌اید نداشته باشد، واحد در زمان نصب برنامه بارگیری نمی‌شود. بااین‌حال، ممکن است برنامه‌تان بعداً بااستفاده از کیت توسعه نرم‌افزار «هسته Play» درخواست کند واحد را به‌صورت درخواستی بارگیری کند.

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

افزودن پیمانه جدید با گزینه‌های ارسال مشروط

ساده‌ترین راه برای ایجاد واحد ویژگی جدید با ارسال مشروط ازطریق جادوی واحد جدید به‌صورت زیر است:

  1. برای باز کردن کادر گفتگوی New Module (واحد جدید)، File (فایل) > New (جدید) > New Module (واحد جدید) را از نوار منو انتخاب کنید.
  2. در کادر گفتگوی «واحد جدید»، واحد ویژگی پویا را انتخاب کنید و روی بعدی کلیک کنید.
  3. ماژولتان را طبق روشی که معمولاً انجام می‌دهید پیکربندی کنید و روی بعدی کلیک کنید.
  4. در بخش گزینه‌های بارگیری واحد، موارد زیر را تکمیل کنید:

    1. عنوان واحد را با حداکثر ۵۰ نویسه مشخص کنید. پلاتفرم از این عنوان برای شناسایی واحد به کاربران استفاده می‌کند، مثلاً هنگام تأیید اینکه آیا کاربر می‌خواهد واحد را بارگیری کند یا نه. به‌همین دلیل، واحد پایه برنامه‌تان باید عنوان واحد را به‌عنوان منبع رشته داشته باشد تا بتوانید آن را ترجمه کنید. هنگام ایجاد واحد بااستفاده از Android Studio، محیط توسعه یکپارچه منبع رشته را به واحد پایه اضافه می‌کند و ورودی زیر را در مانیفست واحد ویژگی تزریق می‌کند:

      <dist:module
          ...
          dist:title="@string/feature_title">
      </dist:module>
      
    2. در منوِ کرکره‌ای زیر گنجاندن در زمان نصب، فقط برای دستگاه‌هایی با ویژگی‌های مشخص‌شده، ماژول در زمان نصب برنامه گنجانده شود را انتخاب کنید. این گزینه ماژولی ایجاد می‌کند که در زمان نصب برنامه فقط در دستگاه‌هایی با پیکربندی‌های خاصی که می‌توانید مشخص کنید (مثل ویژگی‌های دستگاه یا کشور) گنجانده می‌شود. «استودیو Android» موارد زیر را در مانیفست واحد تزریق می‌کند تا انتخاب شما را منعکس کند:

      <dist:module ... >
        <dist:delivery>
            <dist:install-time>
                <dist:conditions>
                    <!-- If you specify conditions, as described in the steps
                         below, the IDE includes them here. -->
                </dist:conditions>
            </dist:install-time>
        </dist:delivery>
      </dist:module>
      
    3. اگر می‌خواهید بارگیری خودکار ماژول را به کشورهای خاصی یا حداقل سطح API محدود کنید، روی پایان کلیک کنید تا ایجاد ماژول تکمیل شود و سپس بخش مربوط به نحوه مشخص کردن شرایط براساس کشور یا حداقل سطح API را بخوانید. درغیراین‌صورت، روی + ویژگی دستگاه کلیک کنید تا ویژگی‌ای را که دستگاه برای بارگیری واحد در زمان نصب نیاز دارد اضافه کنید.

    4. در کنار ویژگی دستگاه، یکی از گزینه‌های زیر را از منو کرکره‌ای انتخاب کنید و مقدار آن را مشخص کنید:

      • نام: به شما امکان می‌دهد ویژگی سخت‌افزاری یا نرم‌افزاری‌ای را مشخص کنید که دستگاه برای بارگیری پیمانه در زمان نصب به آن نیاز دارد. ویژگی‌هایی که ارسال مشروط پشتیبانی می‌کند همان ویژگی‌هایی است که به‌عنوان ثابت‌های FEATURE_* توسط PackageManager فهرست شده است. اگر این گزینه را انتخاب کنید، شروع به تایپ کردن هر بخشی از مقدار ثابت ویژگی، مانند «بلوتوث»، در فیلد کنار منوِ کرکره‌ای کنید و یکی از پیشنهادهای ظاهرشده را انتخاب کنید.
      • نسخه OpenGL ES: به شما امکان می‌دهد نسخه OpenGL ES را که دستگاه برای بارگیری واحد در زمان نصب نیاز دارد مشخص کنید. اگر این گزینه را انتخاب کنید، تایپ کردن نسخه را، مثلاً «0x00030001»، در فیلد کنار منوِ کرکره‌ای شروع کنید و یکی از پیشنهادهای ظاهرشده را انتخاب کنید.
    5. اگر می‌خواهید چند شرط براساس ویژگی‌های دردسترس دستگاه اضافه کنید، روی + ویژگی دستگاه برای هر شرط ویژگی دستگاهی که می‌خواهید مشخص کنید کلیک کنید.

    6. اگر می‌خواهید این واحد برای دستگاه‌های دارای Android نسخه ۴.۴ (سطح میانای برنامه‌سازی کاربردی ۲۰) و پایین‌تر دردسترس باشد و در چند APK گنجانده شود، چارگوش کنار Fusing را علامت بزنید. این یعنی می‌توانید رفتار درخواستی را برای این ماژول فعال کنید و ادغام را غیرفعال کنید تا آن را از دستگاه‌هایی که از بارگیری و نصب APK جداشده پشتیبانی نمی‌کنند حذف کنید. «استودیو Android» موارد زیر را در مانیفست واحد تزریق می‌کند تا انتخاب شما را منعکس کند:

      <dist:module ...>
          <dist:fusing dist:include="true | false" />
      </dist:module>
      
  5. وقتی پیکربندی گزینه‌های بارگیری واحد تمام شد، روی پایان کلیک کنید.

توجه داشته باشید که افزایه Android Gradle از اجرای lint از واحدهای ویژگی پویا پشتیبانی نمی‌کند. اجرای lint از واحد برنامه مربوطه، lint را در واحدهای ویژگی پویای آن اجرا می‌کند و همه مشکلات را در گزارش lint برنامه لحاظ می‌کند.

افزودن گزینه‌های ارسال مشروط به پیمانه ویژگی موجود

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

برای شروع، ابتدا باید مانیفست خود را به عنصر جدید <dist:delivery> منتقل کنید. تکه‌کد زیر نمونه‌ای از نحو قدیمی‌تر را نشان می‌دهد:

<!-- This is the old syntax. -->
<dist:module
  dist:title="@string/feature_title" dist:onDemand="true">
  <dist:fusing dist:include="true"/>
</dist:module>

گزینه‌های تحویل بالا اکنون به‌صورت زیر مشخص شده‌اند.

<dist:module
  dist:title="@string/feature_title">
  <dist:delivery>
      <dist:on-demand/>
  </dist:delivery>
  <dist:fusing dist:include="true"/>
</dist:module>

سپس می‌توانید گزینه‌های ارسال مشروط را براساس ویژگی‌های دستگاه به‌صورت زیر اضافه کنید.

<dist:module
    dist:title="@string/feature_title">
    <dist:delivery>
      <dist:on-demand/>
      <dist:install-time>
        <dist:conditions>
          <!-- Requires that the device support AR to download the module at
          app install-time.  -->
          <dist:device-feature dist:name="android.hardware.camera.ar"/>
        </dist:conditions>
      </dist:install-time>
    </dist:delivery>
    <dist:fusing dist:include="true"/>
</dist:module>

بخش‌های زیر گزینه‌های دیگر برای ارسال مشروط را بررسی می‌کنند، مثل براساس کشور یا حداقل سطح API.

سازگاری با دیگر گزینه‌های بارگیری واحد

چون پیمانه‌های ویژگی گزینه‌های متعددی برای پیکربندی نحوه ارسال هر ویژگی به دستگاه کاربر ارائه می‌دهند، مهم است که بدانید گزینه‌های ارسال مشروط چگونه تحت‌تأثیر تنظیمات دیگر قرار می‌گیرند. جدول زیر سازگاری ارسال مشروط با دیگر گزینه‌های بارگیری مدول را خلاصه می‌کند.

گزینه بارگیری پیمانه سازگاری با تحویل مشروط
درحال ادغام (<dist:fusing dist:include="true"/>) اگر واحدی این گزینه را روی «درست» تنظیم کند، Google Play گزینه‌های ارسال مشروطی را که هنگام استقرار برنامه‌تان در دستگاه‌های دارای سطح API‏ ۱۹ یا پایین‌تر مشخص می‌کنید رعایت نمی‌کند. یعنی واحدهای ویژگی که ادغام را فعال می‌کنند همیشه در زمان نصب برای دستگاهی که سطح میانای برنامه‌سازی کاربردی ۱۹ یا پایین‌تر را اجرا می‌کند گنجانده می‌شوند.
دارای فعال‌سازی آنی (<dist:module dist:instant="true"/>) گزینه‌های تحویل شرطی برای واحدهای ویژگی دارای فعال‌سازی آنی پشتیبانی نمی‌شود.
درصورت درخواست (<dist:on-demand/>) به‌طور پیش‌فرض، اگر گزینه‌های ارسال مشروط را مشخص کنید، پیمانه به‌صورت درخواستی نیز دردسترس است.

مشخص کردن شرایط براساس کشور

تحویل شرطی همچنین به شما امکان می‌دهد مشخص کنید که می‌خواهید کدام کشورها از بارگیری واحد شما در زمان نصب برنامه مستثنی (یا مشمول) شوند. مشخص کردن این شرط ممکن است مفید باشد، برای مثال، اگر واحد شما روش پرداختی را پیاده‌سازی می‌کند که در مناطق خاصی دردسترس نیست.

در این زمینه، کشور دستگاه معمولاً براساس نشانی صورت‌حساب کاربر که در حساب Google Play او ثبت شده است تعیین می‌شود.

برای مشخص کردن کشورها برای واحدتان، موارد زیر را در مانیفست واحد ویژگی بگنجانید.

<dist:conditions>
   <!-- Set to "true" to specify countries to exclude from downloading
   this module at app install-time. By default, modules are available
   for download to all user countries. -->
  <dist:user-countries dist:exclude="true">
    <!-- Specifies the two-letter  CLDR country code for regions that should
    not download the module at app install-time. -->
    <dist:country dist:code="CN"/>
    <dist:country dist:code="HK"/>
  </dist:user-countries>
</dist:conditions>

مشخص کردن شرایط برای سطح میانای برنامه‌سازی کاربردی

مشخص کردن شرط براساس سطح API دستگاه می‌تواند مفید باشد اگر واحد ویژگی به APIهایی وابسته باشد که فقط در نسخه‌های خاصی از پلاتفرم Android دردسترس است.

برای تنظیم شرط براساس حداقل یا حداکثر سطح API دستگاه، موارد زیر را در مانیفست واحد ویژگی‌تان اضافه کنید.

<dist:conditions>
    <!-- Specifies the minimum API level that the device must satisfy
         in order to download your module at app install-time. The API level you
         specify must be greater or equal to the module's own minSdkVersion. -->
   <dist:min-sdk dist:value="21"/>
    <!-- Specifies the maximum API level that the device cannot exceed
         in order to download your module at app install-time. The API level you
         specify must be less than or equal to the module's own maxSdkVersion. -->
   <dist:max-sdk dist:value="24"/>
</dist:conditions>

شرایط را برای دیگر ویژگی‌های دستگاه مشخص کنید (نسخه بتا)

برای مشخص کردن شرایط برای دیگر ویژگی‌های دستگاه، مثل نام مدل، RAM، ویژگی‌های سیستم، و SoC، می‌توانید از فایل پیکربندی هدف‌یابی دستگاه استفاده کنید.

برای ایجاد فایل پیکربندی هدف‌یابی دستگاه، به مستندات هدف‌یابی دستگاه مراجعه کنید.

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

<dist:conditions>
   <dist:device-groups>
      <dist:device-group dist:name="myCustomGroup1"/>
      <dist:device-group dist:name="myCustomGroup2"/>
   </dist:device-groups>
</dist:conditions>