انتشار اپ فلاتر: امضا، بیلد release و آماده‌سازی برای مایکت، بازار و گوگل‌پلی

اپ شما روی شبیه‌ساز کار می‌کند؛ خوب است. حالا باید آن را به دست کاربر برسانید. این راهنما مراحل آماده‌سازی انتشار اندروید را از امضا تا بارگذاری در فروشگاه‌ها مرور می‌کند.

#۱. شناسه و نسخه

• applicationId (مثل ir.example.myapp) هویت یکتای اپ شماست و بعد از انتشار نباید عوض شود.
• نسخه در pubspec.yaml تعریف می‌شود:

version: 1.0.0+1

عدد قبل از + نسخه‌ی نمایشی (versionName) و بعد از آن شماره‌ی بیلد (versionCode) است. با هر انتشار جدید، versionCode باید بزرگ‌تر شود.

#۲. آیکون و نام

برای ساخت آیکون در همه‌ی اندازه‌ها از پکیج flutter_launcher_icons استفاده کنید. نام نمایشی اپ را در android/app/src/main/AndroidManifest.xml (مقدار android:label) تنظیم کنید.

#۳. ساخت کلید امضا (keystore)

اپ اندروید باید با یک کلید دیجیتال امضا شود. یک بار آن را بسازید:

keytool -genkey -v -keystore upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload

فایل keystore و رمزش را در جای امنی نگه دارید و هرگز در مخزن کد (git) قرار ندهید. اگر آن را گم کنید، نمی‌توانید به‌روزرسانی همان اپ را منتشر کنید.

سپس فایل android/key.properties را با مقادیر کلید بسازید و در android/app/build.gradle به بخش signingConfigs معرفی کنید. فایل key.properties هم نباید commit شود.

#۴. ساخت بیلد release

flutter build apk --release        # for Myket, Bazaar and direct download
flutter build appbundle --release  # required format for Google Play

خروجی‌ها در پوشه‌ی build/app/outputs/ ساخته می‌شوند. برای کاهش حجم می‌توانید APK جداگانه برای هر معماری بسازید:

flutter build apk --release --split-per-abi

#۵. قبل از ارسال تست کنید

بیلد release را روی یک گوشی واقعی نصب کنید؛ بعضی خطاها فقط در release دیده می‌شوند (مثلاً دسترسی اینترنت که باید در AndroidManifest.xml اعلام شده باشد). از flutter build apk --release خروجی را نصب کنید و همه‌ی مسیرهای اصلی را امتحان کنید.

#۶. آماده‌سازی صفحه‌ی فروشگاه

• نام کوتاه و جذاب، توضیح کوتاه و توضیح کامل.
• آیکون و حداقل ۴ تا ۵ اسکرین‌شات واقعی.
• دسته‌بندی درست و کلمات کلیدی مرتبط.
• لینک سیاست حفظ حریم خصوصی (برای گوگل‌پلی الزامی است).

#۷. بارگذاری در فروشگاه‌ها

• مایکت و کافه‌بازار: پنل توسعه‌دهنده می‌سازید، فایل APK را بارگذاری و اطلاعات صفحه را تکمیل می‌کنید. بعد از بررسی تیم فروشگاه منتشر می‌شود.
• گوگل‌پلی: حساب توسعه‌دهنده، فرمت AAB و پر کردن فرم‌های محتوا و حریم خصوصی لازم است.

#۸. بعد از انتشار

نظرات کاربران را بخوانید، گزارش خطا (مثل Firebase Crashlytics) را فعال کنید و به‌روزرسانی‌ها را با versionCode بالاتر منتشر کنید.

#چک‌لیست نهایی

• applicationId و نسخه درست‌اند.
• keystore امن و پشتیبان‌گیری شده است.
• بیلد release روی گوشی واقعی تست شده است.
• اسکرین‌شات‌ها و متن‌ها آماده‌اند.

اگر این هشت مرحله را یک بار با دقت بروید، انتشارهای بعدی برایتان چند دقیقه کار است.