title: "راهنمای انتشار برنامه" order: 1 description: "از ورود به کنسول تا اثبات مالکیت، بارگذاری APK، صفحهٔ فروشگاه، بررسی، انتشار مرحله‌ای و به‌روزرسانی"

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

این راهنما مسیر کامل انتشار یک برنامهٔ اندروید در بله‌استور را از صفر توضیح می‌دهد. همهٔ کارها در کنسول توسعه‌دهندگان (https://console.<domain>) انجام می‌شود؛ هر کاری که کنسول انجام می‌دهد با API زیر مسیر /console/v1/ هم شدنی است و در هر مرحله نام endpoint مربوط آمده است.

بله‌استور هرگز کلید امضای شما را نمی‌خواهد و فایل شما را دوباره امضا نمی‌کند. همان APKی که بارگذاری می‌کنید، بایت به بایت به دست کاربر می‌رسد.

۱. حساب کاربری

  • ورود با حساب بله (پیشنهادی): POST /console/v1/auth/bale.
  • ورود با ایمیل و کد یک‌بارمصرف: POST /console/v1/auth/otp/request و سپس POST /console/v1/auth/otp/verify.
  • ورود دومرحله‌ای (TOTP) برای نقش‌های owner، admin و finance الزامی است. اگر یکی از این نقش‌ها را دارید و هنوز TOTP را فعال نکرده‌اید، کنسول شما را به صفحهٔ راه‌اندازی آن می‌برد (POST /console/v1/me/totp/setup و POST /console/v1/me/totp/enable).

۲. سازمان و احراز هویت

هر برنامه متعلق به یک سازمان است، حتی اگر به‌تنهایی کار می‌کنید.

  1. ساخت سازمان: نوع (INDIVIDUAL برای شخص حقیقی یا COMPANY برای شخص حقوقی)، نام نمایشی، نام حقوقی، و در صورت تمایل وب‌سایت، ایمیل پشتیبانی، لوگو و شناسهٔ تماس در بله (POST /console/v1/orgs). سازنده نقش owner می‌گیرد.
  2. احراز هویت (KYC سبک):
    • شخص حقیقی: کد ملی؛
    • شخص حقوقی: شناسهٔ ملی شرکت؛
    • در هر دو حالت: شمارهٔ موبایل با کد تأیید (POST /console/v1/orgs/{orgId}/verification و سپس POST .../verification/mobile).
  3. اعضای تیم: می‌توانید هم‌تیمی‌ها را با یکی از نقش‌های زیر دعوت کنید. همهٔ این کارها در لاگ ممیزی ثبت می‌شوند.
نقش دسترسی اصلی
owner همه‌چیز، از جمله پذیرش قرارداد و احراز هویت
admin مدیریت سازمان، اعضا، برنامه‌ها و انتشار
release_manager بارگذاری نسخه، صفحهٔ فروشگاه، ارسال برای بررسی و کنترل انتشار
finance قیمت‌گذاری، بازپرداخت، درآمد و اطلاعات تسویه (شبا)
support پاسخ به نظرات کاربران
viewer فقط مشاهده

سازمان‌های ناشر مدیریت‌شده (برای ناشران خارجی) فقط توسط کارکنان بله‌استور و با قرارداد رسمی ساخته می‌شوند.

۳. قرارداد توزیع و سیاست محتوا

مالک سازمان باید نسخهٔ جاری قرارداد توزیع توسعه‌دهنده و سیاست محتوا را بپذیرد (GET /console/v1/agreements/current و POST /console/v1/orgs/{orgId}/agreements/accept). قرارداد نسخه‌بندی شده است؛ هر بار که تغییر کند، تا پذیرش دوباره نمی‌توانید نسخهٔ جدیدی برای بررسی بفرستید (خطای AGREEMENT_NOT_ACCEPTED). خلاصهٔ قواعد را در سیاست‌ها ببینید.

۴. بارگذاری اولین APK و ساخت برنامه

برنامه از روی اولین فایل بارگذاری‌شده ساخته می‌شود. لازم نیست چیزی را تایپ کنید؛ این اطلاعات از خود فایل خوانده می‌شوند:

  • نام بسته (packageName)، versionCode و versionName؛
  • minSdk و targetSdk؛
  • ABIها و کتابخانه‌های بومی؛
  • مجوزها (permissions)؛
  • گواهی امضا (اثر انگشت SHA-256 به شکل AB:CD:…) و طرح‌های امضا (v1 تا v4) و زنجیرهٔ چرخش کلید.

قالب‌های پذیرفته‌شده: یک APK یونیورسال، یا مجموعهٔ split (یک base به‌همراه config splitها). AAB در این نسخه پذیرفته نمی‌شود (دلیلش در سیاست‌ها آمده است). سقف حجم هر فایل به‌طور پیش‌فرض ۱ گیگابایت است (قابل تنظیم).

بارگذاری ادامه‌پذیر است؛ اگر اتصال قطع شد، فقط قطعه‌های جاافتاده را دوباره می‌فرستید:

API=https://api.<domain>          # dev: http://localhost:18080
AUTH="Authorization: Bearer $CONSOLE_TOKEN"

# 1) open an upload session
curl -sS -X POST "$API/console/v1/uploads" -H "$AUTH" -H 'content-type: application/json' \
  -d '{"orgId":"'"$ORG_ID"'","fileName":"app-release.apk","sizeBytes":18234567,"purpose":"apk"}'
# → {"uploadId":"…","partSizeBytes":8388608,"totalParts":3,"receivedParts":[],"status":"OPEN","expiresAt":"…"}

# 2) send each part (1-based), raw bytes
curl -sS -X PUT "$API/console/v1/uploads/$UPLOAD_ID/parts/1" -H "$AUTH" \
  -H 'content-type: application/octet-stream' --data-binary @part1.bin

# resume: GET /console/v1/uploads/$UPLOAD_ID shows receivedParts; send only the missing ones

# 3) complete → the file is inspected immediately
curl -sS -X POST "$API/console/v1/uploads/$UPLOAD_ID/complete" -H "$AUTH"
# → {"uploadId":"…","sha256":"…","sizeBytes":…,"inspection":{…},"error":null}

# 4) create the app from one or more uploads (base + config splits = several uploadIds)
curl -sS -X POST "$API/console/v1/orgs/$ORG_ID/apps" -H "$AUTH" -H 'content-type: application/json' \
  -d '{"uploadIds":["'"$UPLOAD_ID"'"]}'
# → {"app":{…},"version":{…},"checks":[…]}

بررسی‌های لحظه‌ای هنگام بارگذاری

بلافاصله پس از بارگذاری این بررسی‌ها اجرا می‌شوند و هر خطا با پیام فارسی دقیق و راه رفع نمایش داده می‌شود (فیلد checks، هر مورد با key، passed، severity، message و fix):

کلید بررسی شرط قبولی
zip_integrity ساختار ZIP سالم باشد (و بمب ZIP نباشد)
manifest_parse AndroidManifest.xml قابل خواندن باشد
version_code versionCode اکیداً بزرگ‌تر از آخرین نسخهٔ منتشرشده باشد
signing_cert گواهی امضا با گواهی ثبت‌شدهٔ برنامه یکی باشد، یا یک زنجیرهٔ چرخش معتبر APK Signature Scheme v3/v3.1 از آن وجود داشته باشد
target_sdk targetSdk در محدودهٔ سیاست باشد
abi_64bit اگر کد بومی دارید، arm64-v8a موجود باشد
debuggable android:debuggable="true" نباشد
size_limit حجم فایل از سقف بیشتر نباشد
package_match همهٔ فایل‌های یک نسخه نام بستهٔ یکسان داشته باشند
split_set مجموعهٔ split کامل و سازگار باشد

کد خطاهای مربوط (مثل VERSION_CODE_NOT_INCREASING یا MISSING_ARM64) در مرجع کدهای خطا آمده است.

۵. اثبات مالکیت بسته

اولین بار که یک نام بسته در بله‌استور ثبت می‌شود، باید ثابت کنید کلید امضای آن را در اختیار دارید. این مرحله همیشه الزامی است:

  1. پس از ساخت برنامه، کنسول یک توکن یک‌بارمصرف به شکل bsp1- + ۳۲ نویسهٔ base32 نشان می‌دهد که ۷ روز اعتبار دارد (GET /console/v1/apps/{appId}/ownership). اگر منقضی شد، توکن تازه بگیرید (POST .../ownership/token).
  2. یک APK اثبات مالکیت کوچک بسازید: همان نام بسته، توکن در یک <meta-data>، امضاشده با همان کلید (طرح v2 یا v3). ابزار balestore-proof یا پروژهٔ الگو این کار را برایتان انجام می‌دهد.
  3. آن را با purpose: "ownership_proof" بارگذاری و ثبت کنید (POST /console/v1/apps/{appId}/ownership/proof {uploadId}).
  4. بله‌استور امضا و توکن را بررسی می‌کند و وضعیت مالکیت VERIFIED می‌شود. فایل اثبات پس از بررسی پاک می‌شود و هرگز منتشر نمی‌شود.

راهنمای گام‌به‌گام و کدهای خطا: ابزار اثبات مالکیت.

نکته‌ها:

  • اگر همین برنامه در فروشگاه دیگری منتشر شده، گواهی امضای فایل شما باید با آن یکی باشد. منبع این مقایسه در حال نهایی‌شدن است؛ فعلاً می‌توانید شواهد (مثلاً پیوند صفحهٔ برنامه در فروشگاه دیگر) را دستی ارسال کنید (POST /console/v1/apps/{appId}/ownership/evidence).
  • اگر یک گواهی امضا زیر دو سازمان نامرتبط دیده شود، هر دو برنامه برای بررسی علامت می‌خورند (certConflict: true)؛ این معمولاً نشانهٔ نشت یا سرقت کلید است.
  • اگر کسی نام بستهٔ شما را ثبت کرده، از مسیر ادعای مالکیت اقدام کنید (POST /console/v1/disputes)؛ کارکنان بله‌استور رسیدگی می‌کنند.

۶. صفحهٔ فروشگاه (Listing)

برای هر زبان یک صفحه دارید؛ فارسی الزامی و انگلیسی اختیاری است (PUT /console/v1/apps/{appId}/listings/{locale}).

فیلد قاعده
عنوان حداکثر ۵۰ نویسه
توضیح کوتاه حداکثر ۸۰ نویسه
توضیح کامل حداکثر ۴۰۰۰ نویسه
آیکون PNG با ابعاد ۵۱۲×۵۱۲
تصاویر صفحه ۲ تا ۸ تصویر گوشی
تصویر شاخص و ویدئو اختیاری
دسته و برچسب‌ها الزامی/اختیاری طبق فرم
ایمیل تماس، وب‌سایت —
نشانی سیاست حریم خصوصی الزامی اگر مجوز حساس یا ردیاب (tracker) دارید
پرسش‌نامهٔ ردهٔ سنی الزامی
اعلام محتوا تبلیغات، خرید درون‌برنامه‌ای، داده‌های جمع‌آوری‌شده
توجیه مجوزهای حساس برای هر مجوز حساس یک متن توجیه

تصاویر را با POST /console/v1/media (multipart، kind = icon | screenshot | feature_graphic | …) بارگذاری کنید. فهرست مجوزهای حساس طبق سیاست جاری از GET /console/v1/sensitive-permissions می‌آید. فیلد validation در پاسخ صفحهٔ فروشگاه، موارد ناقص را نشان می‌دهد؛ خالی بودن آن یعنی صفحه کامل است.

۷. یادداشت انتشار و ارسال برای بررسی

  1. یادداشت انتشار را برای هر زبان بنویسید (PUT /console/v1/versions/{versionId}/release-notes {fa, en?}).
  2. نسخه را ارسال کنید (POST /console/v1/versions/{versionId}/submit). پیش‌شرط‌ها:
    • مالکیت بسته VERIFIED باشد (وگرنه OWNERSHIP_NOT_VERIFIED)؛
    • صفحهٔ فارسی کامل باشد (LISTING_INCOMPLETE)؛
    • قرارداد جاری پذیرفته شده باشد (AGREEMENT_NOT_ACCEPTED)؛
    • همهٔ بررسی‌های بارگذاری قبول شده باشند.

۸. فرایند بررسی

بررسی یک گردش‌کار پایدار و چندمرحله‌ای است. وضعیت زنده و زمان تخمینی پایان را در کنسول می‌بینید (GET /console/v1/versions/{versionId}، فیلد review):

بارگذاری ← بررسی‌های اولیه ← اسکن ← امتیاز ریسک ← بررسی انسانی ← تأیید / رد / نیاز به اصلاح
Uploaded → Checks → Scanning → Risk scoring → In human review → Approved / Rejected / Needs changes
مرحله (stage) چه اتفاقی می‌افتد
UPLOADED فایل دریافت شد.
CHECKS یکپارچگی فایل، امضا و مالکیت، versionCode، targetSdk، ABI ۶۴بیتی، debuggable. خطا در این مرحله سریع و بدون اسکن برمی‌گردد.
SCANNING اسکن‌های موازی: بدافزار (ClamAV، YARA، APKiD)، امنیت ایستا (MobSF)، حریم خصوصی (ردیاب‌ها و مجوزها نسبت به دسته)، تفاوت با نسخهٔ قبل، محتوا و سیاست، جعل هویت (شباهت آیکون، نام و کد).
RISK_SCORING امتیاز ریسک وزن‌دار و قابل توضیح؛ نتیجه یکی از سه مسیر رد خودکار، بررسی انسانی یا تأیید خودکار است.
HUMAN_REVIEW بازبین انسانی گزارش و خلاصهٔ هوشمند را می‌بیند و تصمیم می‌گیرد.
DECIDED تصمیم نهایی: APPROVED، REJECTED یا NEEDS_CHANGES.

زمان‌های معمول (اهداف سرویس، نه تعهد قراردادی): مراحل خودکار کمتر از ۳۰ دقیقه و بررسی انسانی کمتر از ۲۴ ساعت. در فاز فعلی، همهٔ برنامه‌های جدید و نسخه‌هایی که تغییر پرخطر دارند (مثلاً مجوز حساس جدید، SDK یا ردیاب جدید، کتابخانهٔ بومی یا packer جدید) به بررسی انسانی می‌روند.

وضعیت‌های نسخه (status): UPLOADED، CHECKING، SCANNING، SCORED، HUMAN_REVIEW، APPROVED، REJECTED، NEEDS_CHANGES، PUBLISHED، HALTED، PULLED، SUPERSEDED.

پاسخ به رد یا درخواست اصلاح

برای هر بررسی ناموفق، کنسول شاهد (evidence) و گام‌های رفع را به فارسی نشان می‌دهد (review.findings[]: checkKey، title، evidence، fixSteps[]، reasonCode). این متن‌ها را دستیار هوشمند از روی الگوهای تأییدشده می‌نویسد و تصمیم را انسان می‌گیرد.

  • نیاز به اصلاح (NEEDS_CHANGES): مشکل را رفع کنید و نسخهٔ جدید (با versionCode بزرگ‌تر) یا صفحهٔ اصلاح‌شده را دوباره ارسال کنید.
  • اعتراض: اگر تصمیم را نادرست می‌دانید، با یک پیام اعتراض ثبت کنید (POST /console/v1/versions/{versionId}/appeal {message}). اعتراض را یک بازبین ارشد بررسی می‌کند (appeal.status: OPEN، UPHELD، OVERTURNED).

۹. انتشار و انتشار مرحله‌ای

پس از تأیید (APPROVED) خودتان زمان انتشار را تعیین می‌کنید (POST /console/v1/versions/{versionId}/release):

{ "mode": "scheduled", "at": "2026-11-21T06:30:00Z", "ladder": [1, 10, 100], "autoAdvance": true }
  • mode: now (همین حالا) یا scheduled (در زمان at).
  • ladder: پله‌های درصدی انتشار مرحله‌ای برای به‌روزرسانی خودکار؛ پیش‌فرض [1, 10, 100].
  • autoAdvance: اگر نرخ موفقیت نصب و سیگنال‌های کرش سالم باشند، طبق زمان‌بندی به پلهٔ بعد می‌رود.

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

کنترل انتشار (POST /console/v1/versions/{versionId}/rollout):

action اثر
pause توقف موقت بالا رفتن درصد
resume ادامهٔ نردبان
advance رفتن فوری به پلهٔ بعد
halt توقف کامل؛ سرور دیگر این نسخه را پیشنهاد نمی‌دهد و دستگاه‌هایی که هنوز نصب نکرده‌اند، آن را نمی‌گیرند (با reason)

بازگشت (Rollback)

اندروید اجازهٔ نصب نسخهٔ قدیمی‌تر روی نسخهٔ جدیدتر را نمی‌دهد. پس «بازگشت» در عمل یعنی: انتشار را halt کنید و نسخهٔ اصلاح‌شده‌ای با versionCode بالاتر بفرستید. نسخهٔ تأییدشدهٔ قبلی را فقط وقتی می‌توانید دوباره منتشر کنید که versionCode آن بالاتر از نسخهٔ فعلی باشد.

۱۰. به‌روزرسانی‌ها

برای هر نسخهٔ جدید:

  1. فایل(ها) را بارگذاری کنید و نسخه بسازید (POST /console/v1/apps/{appId}/versions {uploadIds}).
  2. versionCode باید اکیداً بزرگ‌تر از آخرین نسخهٔ منتشرشده باشد.
  3. امضا باید با همان گواهی یا از طریق زنجیرهٔ چرخش معتبر v3/v3.1 باشد. اثبات مالکیت فقط برای اولین بار لازم است.
  4. یادداشت انتشار، ارسال برای بررسی، انتشار.

به‌روزرسانی بی‌صدا: بله روی اندروید ۱۲ به بالا می‌تواند برنامهٔ شما را بدون تأیید کاربر به‌روز کند، به شرطی که بله نصب‌کنندهٔ ثبت‌شده (installer of record) یا مالک به‌روزرسانی باشد و targetSdk برنامه از حداقلِ مربوط به نسخهٔ اندروید دستگاه کمتر نباشد. جدول فعلی (از پیکربندی راه دور؛ با هر نسخهٔ اندروید تغییر می‌کند):

اندروید دستگاه حداقل targetSdk برنامه
12 (API 31) 29
13 (API 33) 30
14 (API 34) 31
15 (API 35) 33
16 (API 36) 34

اگر کاربر برنامه را از فروشگاه دیگری با همان گواهی نصب کرده باشد، اولین به‌روزرسانی از بله‌استور یک بار تأیید کاربر می‌خواهد و پس از آن بله نصب‌کنندهٔ ثبت‌شده می‌شود. اگر گواهی متفاوت باشد، به‌روزرسانی اصلاً پیشنهاد نمی‌شود.

۱۱. پس از انتشار

  • تاریخچهٔ نسخه‌ها با گزارش خلاصهٔ بررسی، تعداد نصب و نرخ موفقیت نصب.
  • آمار (با تأخیر کمتر از یک ساعت): نصب، حذف، به‌روزرسانی، نرخ موفقیت نصب به تفکیک مدل گوشی و نسخهٔ اندروید، کدهای خطای پرتکرار، خرید و درآمد، منبع ترافیک.
  • پاسخ به نظرات کاربران و گزارش نظرهای توهین‌آمیز.
  • حذف فوری (kill switch): اگر نسخه‌ای خطرناک تشخیص داده شود، کارکنان بله‌استور می‌توانند آن را فوراً از دسترس خارج کنند (PULLED) و به کاربرانی که نصب کرده‌اند هشدار دهند. بله‌استور هرگز برنامه را بی‌صدا از گوشی کاربر حذف نمی‌کند.