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).
۲. سازمان و احراز هویت
هر برنامه متعلق به یک سازمان است، حتی اگر بهتنهایی کار میکنید.
- ساخت سازمان: نوع (
INDIVIDUALبرای شخص حقیقی یاCOMPANYبرای شخص حقوقی)، نام نمایشی، نام حقوقی، و در صورت تمایل وبسایت، ایمیل پشتیبانی، لوگو و شناسهٔ تماس در بله (POST /console/v1/orgs). سازنده نقشownerمیگیرد. - احراز هویت (KYC سبک):
- شخص حقیقی: کد ملی؛
- شخص حقوقی: شناسهٔ ملی شرکت؛
- در هر دو حالت: شمارهٔ موبایل با کد تأیید (
POST /console/v1/orgs/{orgId}/verificationو سپسPOST .../verification/mobile).
- اعضای تیم: میتوانید همتیمیها را با یکی از نقشهای زیر دعوت کنید. همهٔ این کارها در لاگ ممیزی ثبت میشوند.
| نقش | دسترسی اصلی |
|---|---|
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) در مرجع کدهای خطا آمده است.
۵. اثبات مالکیت بسته
اولین بار که یک نام بسته در بلهاستور ثبت میشود، باید ثابت کنید کلید امضای آن را در اختیار دارید. این مرحله همیشه الزامی است:
- پس از ساخت برنامه، کنسول یک توکن یکبارمصرف به شکل
bsp1-+ ۳۲ نویسهٔ base32 نشان میدهد که ۷ روز اعتبار دارد (GET /console/v1/apps/{appId}/ownership). اگر منقضی شد، توکن تازه بگیرید (POST .../ownership/token). - یک APK اثبات مالکیت کوچک بسازید: همان نام بسته، توکن در یک
<meta-data>، امضاشده با همان کلید (طرح v2 یا v3). ابزارbalestore-proofیا پروژهٔ الگو این کار را برایتان انجام میدهد. - آن را با
purpose: "ownership_proof"بارگذاری و ثبت کنید (POST /console/v1/apps/{appId}/ownership/proof {uploadId}). - بلهاستور امضا و توکن را بررسی میکند و وضعیت مالکیت
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 در پاسخ صفحهٔ فروشگاه، موارد ناقص را نشان میدهد؛ خالی بودن آن یعنی صفحه کامل است.
۷. یادداشت انتشار و ارسال برای بررسی
- یادداشت انتشار را برای هر زبان بنویسید (
PUT /console/v1/versions/{versionId}/release-notes {fa, en?}). - نسخه را ارسال کنید (
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 آن بالاتر از نسخهٔ فعلی باشد.
۱۰. بهروزرسانیها
برای هر نسخهٔ جدید:
- فایل(ها) را بارگذاری کنید و نسخه بسازید (
POST /console/v1/apps/{appId}/versions {uploadIds}). versionCodeباید اکیداً بزرگتر از آخرین نسخهٔ منتشرشده باشد.- امضا باید با همان گواهی یا از طریق زنجیرهٔ چرخش معتبر v3/v3.1 باشد. اثبات مالکیت فقط برای اولین بار لازم است.
- یادداشت انتشار، ارسال برای بررسی، انتشار.
بهروزرسانی بیصدا: بله روی اندروید ۱۲ به بالا میتواند برنامهٔ شما را بدون تأیید کاربر بهروز کند، به شرطی که بله نصبکنندهٔ ثبتشده (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) و به کاربرانی که نصب کردهاند هشدار دهند. بلهاستور هرگز برنامه را بیصدا از گوشی کاربر حذف نمیکند.