فایل‌های APK و آهنگ‌ها

Google Play Developer API به شما امکان می‌دهد فایل‌های APK جدید را برای برنامه‌های خود آپلود کنید و آنها را در مسیرهای انتشار مختلف منتشر کنید. این به شما امکان می دهد نسخه های آلفا و بتا برنامه خود را که در دسترس کاربران تأیید شده قرار می گیرند، اجرا کنید. این همچنین به شما امکان می‌دهد یک نسخه عرضه مرحله‌ای را اجرا کنید، که به طور خودکار در دسترس تعداد کمی از کاربران برنامه قرار می‌گیرد. هنگامی که نسخه عرضه مرحله‌ای را منتشر کردید، می‌توانید به تدریج تعداد کاربرانی را که آن نسخه از برنامه را دریافت می‌کنند افزایش دهید تا در نهایت آن نسخه را به عنوان نسخه «تولید» اجرا کنید.

افزودن و اصلاح فایل های APK

  1. با فراخوانی روش آپلود Edits.apks: یک یا چند APK آپلود کنید.

    این روش APK را در یک "سطل" ذخیره سازی آپلود می کند، جایی که می توان آن را به یک "تراک" اختصاص داد تا آن را برای کاربران مستقر کند. (اگر ویرایش حذف یا نادیده گرفته شود، هر فایل APK آپلود شده در آن ویرایش نیز از بین خواهد رفت.)

  2. با تماس با Edits.tracks: به‌روزرسانی ، فایل‌های APK را در «تراک‌ها» منتشر کنید. می‌توانید فایل‌های APK را در آهنگ‌های زیر منتشر کنید:

    • تست آهنگ هایی مانند "alpha" و "beta"

      نسخه‌های آلفا و بتا برنامه برای کاربرانی که به گروه‌های آزمایشی آلفا و بتا اختصاص می‌دهید، مستقر می‌شوند. شما با استفاده از کنسول Google Play کاربران را به این گروه ها اختصاص می دهید.

    • مسیر تست داخلی: "qa"

      نسخه‌های داخلی برنامه شما همانطور که در کنسول Google Play پیکربندی شده است، در مسیر آزمایشی داخلی شما مستقر می‌شوند.

    • مسیر تولید: "production"

      انتشار در مسیر "تولید" برای همه کاربران مستقر است. می‌توانید از نسخه‌های مرحله‌ای در مسیر «تولید» استفاده کنید تا به‌طور ایمن انتشار خود را ابتدا برای درصد کمی از کاربران تولید پخش کنید و سپس به تدریج با افزایش اعتماد به انتشار، این درصد را افزایش دهید.

    کاربران حالت ساده نباید بیش از یک APK را در هر آهنگی قرار دهند. کاربران حالت پیشرفته با استفاده از پشتیبانی APK چندگانه می‌توانند صفر، یک یا چند APK را در هر آهنگ آپلود کنند.

نام تراک برای آهنگ های فاکتور فرم

نام تراک برای تراک فاکتور فرم با یک شناسه خاص پیشوند است.

فاکتور فرم پیشوند
سیستم عامل Android Automotive خودرو
سیستم عامل بپوشید پوشیدن
Android TV تلویزیون

چگونه نام تراک را برای یک تراک فرم فاکتور معین محاسبه کنیم؟

انواع آهنگ های رایج مانند مسیر تولید، تست باز و مسیر تست داخلی دارای نام شناخته شده ای هستند.

نوع آهنگ نام آهنگ پیش فرض
تولید تولید
تست باز بتا
تست داخلی ق

نام تراک برای یک تراک فاکتور فرم معین را می توان به صورت زیر محاسبه کرد: "[prefix]:defaultTrackName" . برای مثال فرم فاکتور Wear OS دارای آهنگ هایی با نام: "wear:production" ، "wear:beta" و "wear:qa" خواهد بود.

مسیرهای تست بسته به صورت دستی ایجاد می شوند و نام های سفارشی دارند. بنابراین یک مسیر آزمایشی بسته برای یک فرم فاکتور با نام $name نام تراک "[prefix]:$name" خواهد داشت.

نمونه گردش کار APK

این بخش یک روش معمولی برای استفاده از Tracks API را شرح می دهد. در این مورد، فرض می‌کنیم که می‌خواهید نسخه‌های جدید APK را برای هر آهنگ آپلود کنید و تعدادی از کاربران را برای دریافت نسخه عرضه مرحله‌ای تعیین کنید. (در عمل، بعید است که یک توسعه‌دهنده همه این اقدامات را در یک عملیات انجام دهد؛ در عوض، ممکن است یک روز نسخه بتا را به‌روزرسانی کنید، یک روز دیگر نسخه مرحله‌ای را در «تولید» ایجاد کنید و غیره.)

  1. همانطور که در Edits Workflow توضیح داده شده است، ویرایش جدیدی را باز کنید
  2. برای هر APKی که می‌خواهید آپلود کنید، روش آپلود Edits.apks: تماس بگیرید. APK را در بدنه درخواست متد ارسال کنید. (این APK را در یک منطقه ذخیره سازی قرار می دهد، اما آن را در یک آهنگ منتشر نمی کند یا آن را مستقر نمی کند.) این روش یک کد نسخه را برای هر APK که آپلود می کنید، برمی گرداند. شما از این کد نسخه برای ارجاع به APK هنگام انتشار آن در یک آهنگ استفاده خواهید کرد.
  3. برای هر آهنگی که می‌خواهید فایل‌های APK را روی آن منتشر کنید ، روش به‌روزرسانی Edits.tracks را فراخوانی کنید. در بدنه درخواست، یک منبع Edits.tracks را ارسال کنید که حاوی نسخه‌ای است که می‌خواهید عرضه کنید. به عنوان مثال، برای انتشار یک APK با کد نسخه 88:

    {
    "releases": [{
      "versionCodes": ["88"],
      "status": "completed"
    }]
    }
    

    در این مرحله، APK ها هنوز در دسترس کاربران نیستند. مانند سایر ویرایش‌ها، تغییرات تا زمانی که آنها را انجام ندهید فعال نمی‌شوند.

  4. برای انجام تغییرات، متد Edits: commit را فراخوانی کنید. پس از انجام این کار، نسخه به روز شده APK به کاربران هر آهنگ داده می شود. (مانند تمام ویرایش‌ها، ممکن است چندین ساعت طول بکشد تا تغییرات اعمال شوند.)

عرضه های مرحله بندی شده

هنگامی که نسخه جدیدی از APK خود دارید که می‌خواهید به تدریج آن را گسترش دهید، می‌توانید آن را به‌عنوان نسخه «عرضه مرحله‌ای» منتشر کنید. اگر این کار را انجام دهید، Google Play به طور خودکار آن را در بخش مورد نظر از کاربران برنامه که شما مشخص کرده اید، مستقر می کند. اگر APK «عرضه‌شده» هیچ مشکلی (مانند خرابی و غیره) نداشته باشد، ممکن است تعداد کاربرانی که آن نسخه را دریافت می‌کنند افزایش دهید. وقتی آماده شدید، می توانید آن APK را به عنوان نسخه تولیدی جدید مستقر کنید.

این بخش مراحلی را که برای اجرای مرحله‌ای از یک APK طی می‌کنید و سپس آن را به تولید ارتقا می‌دهید شرح می‌دهد:

  1. همانطور که در Edits Workflow توضیح داده شده است، یک ویرایش ایجاد کنید.

  2. با استفاده از روش آپلود Edits.apks: یک APK جدید در ویرایش آپلود کنید.

  3. با استفاده از روش Edits.tracks: به روز رسانی، انتشار مرحله ای "inProgress" را در مسیر تولید شروع کنید. کسری از کاربرانی را که باید APK جدید دریافت کنند، انتخاب کنید. در این مرحله، APK هنوز برای هیچ کاربر نهایی در دسترس نیست.

    {
    "releases": [{
      "versionCodes": ["99"],
      "userFraction": 0.05,
      "status": "inProgress"
    }]
    }
    

  4. با فراخوانی Edits: commit تغییرات را در ویرایش فعال انجام دهید. طی چند ساعت آینده، APK جدید برای کاربران عرضه خواهد شد. بخشی از کاربرانی که انتخاب می کنید، APK جدید را دریافت خواهند کرد.

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

افزایش کسر کاربر برای عرضه مرحله‌ای

با فرض اینکه شما یک عرضه مرحله‌ای در حال انجام با 5% دارید، همانطور که در بخش قبل توضیح داده شد، این بخش نحوه افزایش درصد را در مواردی که انتشار به خوبی پیش می‌رود توضیح می‌دهد:

  1. همانطور که در Edits Workflow توضیح داده شده است، یک ویرایش ایجاد کنید.

  2. نسخه مرحله‌ای "inProgress" را در مسیر تولید با استفاده از روش Edits.tracks: به‌روزرسانی تغییر دهید. افزایش بخشی از کاربرانی که باید APK جدید را دریافت کنند:

    {
    "releases": [{
      "versionCodes": ["99"],
      "userFraction": 0.1,
      "status": "inProgress"
    }]
    }
    

  3. با فراخوانی Edits: commit تغییرات را در ویرایش فعال انجام دهید. طی چند ساعت آینده، APK جدید برای کاربران عرضه خواهد شد. بخشی از کاربرانی که انتخاب می‌کنید، APK جدید را دریافت خواهند کرد.

توقف عرضه مرحله‌ای

با فرض اینکه شما یک عرضه مرحله‌ای در حال انجام با 5% دارید، همانطور که در بخش قبل توضیح داده شد، این بخش نحوه توقف عرضه مرحله‌ای را در مواردی که مشکلی را کشف کردید، توضیح می‌دهد:

  1. همانطور که در Edits Workflow توضیح داده شده است، یک ویرایش ایجاد کنید.

  2. نسخه مرحله‌ای "inProgress" را در مسیر تولید با استفاده از روش Edits.tracks: به‌روزرسانی تغییر دهید. وضعیت را روی "halted" تنظیم کنید.

    {
    "releases": [{
      "versionCodes": ["99"],
      "status": "halted"
    }]
    }
    

  3. با فراخوانی Edits: commit تغییرات را در ویرایش فعال انجام دهید. نسخه شما دیگر برای کاربران جدید در دسترس نخواهد بود.

اگر بعداً تصمیم گرفتید یک نسخه متوقف شده را از سر بگیرید، می توانید این کار را با بازگرداندن وضعیت آن به "inProgress" انجام دهید.

تکمیل عرضه مرحله‌ای

هنگامی که از عرضه مرحله‌ای خود راضی بودید و می‌خواهید نسخه را برای 100٪ کاربران عرضه کنید، می‌توانید وضعیت انتشار را روی "completed" تنظیم کنید:

  1. همانطور که در Edits Workflow توضیح داده شده است، یک ویرایش ایجاد کنید.

  2. نسخه مرحله‌ای "inProgress" را در مسیر تولید با استفاده از روش Edits.tracks: به‌روزرسانی تغییر دهید. وضعیت را روی "completed" تنظیم کنید.

    {
    "releases": [{
      "versionCodes": ["99"],
      "status": "completed"
    }]
    }
    

  3. با فراخوانی Edits: commit تغییرات را در ویرایش فعال انجام دهید. طی چند ساعت آینده، APK جدید برای کاربران عرضه خواهد شد. بخشی از کاربرانی که انتخاب می‌کنید، APK جدید را دریافت خواهند کرد.

نسخه های پیش نویس

نسخه‌های پیش‌نویس به شما این امکان را می‌دهند که فایل‌های APK را به‌طور خودکار آپلود کنید و نسخه‌ای را از طریق API ایجاد کنید که بعداً می‌تواند از طریق کنسول Google Play اجرا شود. برای ایجاد نسخه پیش نویس در یک آهنگ:

  1. همانطور که در Edits Workflow توضیح داده شده است، ویرایش جدیدی را باز کنید
  2. برای هر APKی که می‌خواهید آپلود کنید، روش آپلود Edits.apks: تماس بگیرید. APK را در بدنه درخواست متد ارسال کنید. این روش برای هر APK که آپلود می‌کنید یک کد نسخه برمی‌گرداند. از این کد نسخه برای ارجاع به APK زمانی که آن را به نسخه ای اختصاص می دهید استفاده خواهید کرد.
  3. برای هر آهنگی که می‌خواهید منتشر کنید، روش Edits.tracks: به‌روزرسانی را فراخوانی کنید. در بدنه درخواست، یک منبع Edits.tracks حاوی نسخه پیش‌نویسی که می‌خواهید ایجاد کنید، ارسال کنید. به عنوان مثال:

    {
    "releases": [{
      "name": "My draft release",
      "versionCodes": ["88"],
      "status": "draft"
    }]
    }
    

  4. برای انجام تغییرات، متد Edits: commit را فراخوانی کنید. نسخه پیش‌نویس شما اکنون می‌تواند از طریق کنسول Google Play یا API بررسی و عرضه شود.

مشخص کردن یادداشت های انتشار

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

برای این کار از فیلد "releaseNotes" هنگام ارائه منبع Edits.tracks به روش Edits.tracks: update استفاده کنید.

{
  "releases": [{
      "name": "Release with notes",
      "versionCodes": ["88"],
      "status": "completed",
      "releaseNotes": [
        {"language": "en-US", "text": "Describe what's new in this release."}
      ]
  }]
}