مقدمات و راهاندازی محیط توسعه اندروید
توسعه برنامههای بومی اندروید در سالیان اخیر دستخوش تغییرات بنیادین شده است. از ابزارهای رابط کاربری گرفته تا زبانهای برنامهنویسی و حتی الزامات انتشار در گوگل پلی، همه و همه متحول شدهاند. دیگر راهنماهای قدیمی که بر پایه XML layouts و findViewById بنا شدهاند، با واقعیت امروز توسعه اندروید همخوانی ندارند. در این بخش، مسیر کامل ساخت یک اپلیکیشن بومی اندروید با استفاده از جدیدترین ابزارها و تکنیکها، از جمله Jetpack Compose و Kotlin، و سپس مراحل آمادهسازی و انتشار آن در Google Play Store را بررسی میکنیم. هدف ما فراتر از صرفاً اجرای برنامه روی شبیهساز است؛ شما با تمام جزئیات مربوط به بیلد ریلیز، کلیدهای امضا، باندلهای برنامه، لیستینگ فروشگاه، فرمهای سیاست و دوره تست اجباری برای اکانتهای توسعهدهنده جدید آشنا خواهید شد.
پیشنیازهای ضروری برای شروع توسعه
برای شروع این مسیر در کدنویسی اندروید، نیاز به پیشزمینه قوی در برنامهنویسی اندروید ندارید، اما آشنایی با مفاهیم پایهای برنامهنویسی و مطالعه اولیه زبان کاتلین (Kotlin) توصیه میشود. هر مفهوم خاص اندروید در جای خود توضیح داده خواهد شد. ابزارهایی که برای این دوره نیاز دارید عبارتند از:
- یک کامپیوتر با سیستمعامل macOS، Windows یا Linux و حداقل 16 گیگابایت رم. (8 گیگابایت هم کار میکند، اما شبیهساز کند خواهد بود.)
- آخرین نسخه پایدار Android Studio.
- یک گوشی اندرویدی فیزیکی (اختیاری برای توسعه، اما برای تأیید حساب کاربری در Play Console ضروری است).
- یک حساب کاربری گوگل و 25 دلار آمریکا برای پرداخت هزینه یکباره ثبتنام توسعهدهنده گوگل پلی.
آنچه خواهید ساخت: اپلیکیشن Quick Notes
اپلیکیشن نمونهای که در این دوره خواهید ساخت، Quick Notes نام دارد. این برنامه ساده اما کامل، به شما امکان میدهد لیستی از یادداشتها را مشاهده کنید که بر اساس آخرین زمان ویرایش مرتب شدهاند، یک یادداشت جدید با استفاده از دکمه اکشن شناور (Floating Action Button) ایجاد کنید، با ضربه زدن روی یک یادداشت آن را ویرایش کنید، و یادداشتها را حذف کنید. تمامی اطلاعات به صورت محلی در یک پایگاه داده SQLite روی دستگاه ذخیره میشوند، به این معنی که برنامه به صورت آفلاین کار میکند و نیازی به بکاند (Backend) ندارد.
این اپلیکیشن با وجود سادگی، تمامی اجزای ضروری یک برنامه واقعی از جمله صفحه لیست، صفحه جزئیات، ناوبری (Navigation) بین آنها با دکمه بازگشت فعال، ذخیرهسازی پایدار، مدیریت وضعیت در برابر تغییرات پیکربندی (مانند چرخش صفحه) و ورودی کاربر را پوشش میدهد. معماری این برنامه شامل سه لایه اصلی UI Layer، ViewModel و Data Layer است که دادهها به صورت جریان (Flow) به سمت بالا حرکت کرده و رابط کاربری به صورت خودکار با تغییرات پایگاه داده بهروز میشود. درک چگونگی ارتباط این اجزا، پایه و اساس ساخت هر اپلیکیشن اندرویدی دیگری خواهد بود.
راهاندازی محیط توسعه اندروید استودیو
برای شروع کدنویسی، ابتدا باید محیط توسعه خود را آماده کنید:
- دانلود و نصب Android Studio: آخرین نسخه Android Studio را از آدرس
developer.android.com/studioدانلود و نصب کنید. در اولین اجرا، ویزارد تنظیمات به صورت خودکار Android SDK، ابزارهای پلتفرم (از جمله adb) و یک ایمیج سیستمی برای شبیهساز را دانلود میکند. مگر اینکه دلیل خاصی داشته باشید، گزینههای پیشفرض را بپذیرید. Android Studio JDK مخصوص به خود را دارد، بنابراین نیازی به نصب جداگانه Java نیست. - تأیید پلتفرم اندروید: پس از اتمام نصب، SDK Manager را از مسیر
Tools > SDK Managerباز کنید و مطمئن شوید که آخرین پلتفرم پایدار اندروید نصب شده است. در زمان نگارش این مقاله، این به معنای حداقل Android 16 (سطح API 36) است. گوگل پلی از برنامههای جدید و بهروزرسانیها میخواهد که سطح API جدیدی را هدف قرار دهند، و این الزام هر سال، معمولاً در پایان ماه آگوست، بهروز میشود. - ایجاد شبیهساز: از مسیر
Tools > Device Managerیک شبیهساز (Emulator) جدید ایجاد کنید. یک پروفایل گوشی پیکسل جدید و جدیدترین ایمیج سیستمی دارای سرویسهای گوگل پلی را انتخاب کنید. - تست با گوشی فیزیکی (اختیاری): اگر ترجیح میدهید روی گوشی فیزیکی تست کنید، ابتدا
Developer Optionsرا در دستگاه خود فعال کنید. برای این کار، هفت بار رویBuild numberدر مسیرSettings > About phoneضربه بزنید، سپسUSB debugging(یاWireless debugging) را از منویDeveloper Optionsروشن کنید.
ایجاد پروژه جدید با Jetpack Compose
پس از راهاندازی محیط توسعه، نوبت به ایجاد پروژه جدید میرسد:
- انتخاب قالب پروژه: در Android Studio، از منوی
File > New > New Projectرا انتخاب کنید. حتماً قالبEmpty Activityرا برگزینید، زیرا این قالب مبتنی بر Compose است و برای توسعه مدرن اندروید توصیه میشود. قالبEmpty Views Activityکه نام مشابهی دارد، از سیستم طرحبندی قدیمی XML استفاده میکند. - جزئیات پروژه:
- Name (نام): نامی که کاربران میبینند (مثلاً Quick Notes).
- Package name (نام پکیج): شناسه دائمی و منحصربهفرد جهانی برنامه شما در گوگل پلی، که در فرمت دامنه معکوس (مانند
com.yourname.quicknotes) نوشته میشود. در انتخاب آن دقت کنید، زیرا پس از انتشار قابل تغییر نیست. - Minimum SDK (حداقل SDK): آن را روی API 24 تنظیم کنید که تقریباً تمامی دستگاههای فعال اندروید را پوشش میدهد.
- Build configuration language (زبان پیکربندی بیلد): آن را روی Kotlin DSL بگذارید، چرا که زبان استاندارد و توصیهشده برای پروژههای جدید است.
- اتمام و همگامسازی: روی
Finishکلیک کنید و منتظر بمانید تا اولین همگامسازی Gradle تکمیل شود. - تأیید راهاندازی: پس از همگامسازی موفق، دکمه سبز
Runرا فشار دهید. پس از یک بیلد کوتاه، شبیهساز باید پیام"Hello Android!"را روی صفحه نمایش دهد. این کار تأیید میکند که زنجیره ابزار (toolchain) شما به درستی کار میکند و آماده ادامه کدنویسی هستید.
طراحی معماری و ذخیره سازی داده با Room
در توسعه اپلیکیشنهای اندروید مدرن، انتخاب یک معماری قوی و روش مناسب برای ذخیرهسازی دادهها از اهمیت بالایی برخوردار است. این رویکرد نه تنها به افزایش قابلیت نگهداری و مقیاسپذیری پروژه کمک میکند، بلکه تجربه کاربری را نیز بهبود میبخشد. راهنمای گوگل برای معماری اپلیکیشنها، یک ساختار لایهای را پیشنهاد میدهد که مدیریت پیچیدگیها را سادهتر میکند. در این بخش، به بررسی این معماری و نحوه پیادهسازی ذخیرهسازی دادههای محلی با استفاده از کتابخانه Room Jetpack میپردازیم که برای هر توسعهدهندهای که به دنبال ایجاد یک اپلیکیشن پایدار و کارآمد است، از اهمیت بالایی برخوردار است. این اصول حتی در پروژههای نرمافزاری دیگر مانند توسعه برای سیستمهای مدیریت محتوا (CMS) نیز کاربرد دارند و به سازماندهی بهتر کد و دادهها کمک میکنند.
معماری لایهای و ساختار پروژه
معماری پیشنهادی گوگل برای اپلیکیشنهای اندروید شامل سه لایه اصلی است که به صورت عمودی روی هم قرار گرفتهاند و جریان وابستگیها به سمت پایین است: لایه رابط کاربری (UI)، لایه ViewModel و لایه داده (Data Layer). لایه UI در بالای این پشته قرار دارد و شامل `MainActivity` و صفحاتی مانند `NoteListScreen` و `NoteEditorScreen` است. این لایه تنها با ViewModel ارتباط برقرار میکند و هرگز مستقیماً با پایگاه داده تعامل ندارد. ViewModel در لایه میانی، مسئول نگهداری وضعیت رابط کاربری است و میتواند در برابر تغییرات پیکربندی (مانند چرخش صفحه) دوام بیاورد. این لایه همچنین عملیاتهای Coroutine را برای انجام کارهای طولانیمدت راهاندازی میکند.
لایه داده در پایین قرار دارد و مسئولیت دسترسی به دادهها را بر عهده دارد، که در اینجا شامل `NoteRepository`، `NoteDao` و `NotesDatabase` (که بر اساس Room و SQLite ساخته شده است) میشود. جریان دادهها به صورت `Flow` از لایه داده به سمت بالا برمیگردد، به این معنی که هر زمان پایگاه داده تغییر کند، رابط کاربری به طور خودکار بهروزرسانی میشود. برای سازماندهی بهتر کد، فایلها بر اساس لایهبندی در پکیجهای مجزا گروهبندی میشوند. به عنوان مثال، پکیج `data` شامل `Note.kt` (یک Entity)، `NoteDao.kt` (یک Data Access Object)، `NotesDatabase.kt` (کلاس پایگاه داده Room) و `NoteRepository.kt` (یک Repository) است. پکیج `ui` نیز شامل `NotesViewModel.kt` و فایلهای مربوط به صفحات رابط کاربری است. این رویکرد ماژولار به مدیریت بهتر کد و توسعههای آینده، مشابه آنچه در یک قالب وردپرس با امکانات زیاد نیاز است، کمک شایانی میکند.
Room: کتابخانه پایداری داده Jetpack
Room یک کتابخانه پایداری (Persistence Library) از مجموعه Jetpack است که یک لایه انتزاعی بر روی SQLite فراهم میکند. این کتابخانه به توسعهدهندگان امکان میدهد تا جداول پایگاه داده را به عنوان کلاسهای Kotlin (`@Entity`) و کوئریها را به عنوان متدهای یک اینترفیس `@Dao` تعریف کنند. Room سپس در زمان کامپایل، کد SQLite مربوطه را تولید میکند. یکی از مزایای اصلی Room، بررسی کوئریها در زمان بیلد است؛ به این معنی که اشتباه تایپی در نام ستونها به جای کرش کردن اپلیکیشن در دستگاه کاربر، به یک خطای کامپایلری تبدیل میشود.
در اپلیکیشن Quick Notes، کلاس `Note` به عنوان یک Entity با استفاده از `@Entity(tableName = “notes”)` تعریف میشود که هر ویژگی آن (مانند `id`, `title`, `body`, `updatedAt`) به یک ستون تبدیل میگردد. فیلد `id` به عنوان کلید اصلی با `autoGenerate = true` تعیین شده تا SQLite به طور خودکار یک ID جدید برای ردیفهای جدید اختصاص دهد. `NoteDao` نیز اینترفیسی است که متدهایی مانند `observeAll()` برای دریافت تمام یادداشتها به صورت `Flow` (که به محض تغییر دادهها مقادیر جدیدی را منتشر میکند)، `getById()` برای دریافت یک یادداشت خاص، `upsert()` برای درج یا بهروزرسانی یادداشت و `delete()` را ارائه میدهد. متدهای `suspend` اطمینان میدهند که عملیات پایگاه داده در یک رشته پسزمینه اجرا میشوند و رابط کاربری مسدود نمیگردد. کلاس `NotesDatabase` که از `RoomDatabase` ارثبری میکند، با استفاده از `@Database` تمام Entityها و نسخه طرح (schema version) پایگاه داده را لیست میکند. تنظیم `exportSchema = true` به Room اجازه میدهد تا یک توصیف JSON از هر نسخه از طرح پایگاه داده را در یک پوشه `schemas` ذخیره کند که برای اعتبارسنجی و تولید خودکار migrationها در آینده بسیار مفید است؛ امری حیاتی برای بهینهسازی پایگاه داده و پایداری در بهروزرسانیهای نرمافزاری.
الگوی مخزن (Repository) و مدیریت تکین
الگوی مخزن یا Repository، یک لایه نازک بین ViewModel و Room ایجاد میکند. این لایه در اپلیکیشن Quick Notes عمدتاً وظیفه فوروارد کردن فراخوانیها را بر عهده دارد، اما فضای مناسبی برای افزودن منطقهایی مانند کشینگ (caching)، همگامسازی شبکه یا اعتبارسنجی دادهها در آینده فراهم میکند، بدون اینکه کد رابط کاربری تحت تأثیر قرار گیرد. `NoteRepository` یک `NoteDao` را در سازنده خود دریافت میکند، که نمونهای از Dependency Injection در سادهترین شکل آن است. این کار امکان تست آسانتر را فراهم میکند، زیرا میتوان در زمان تست یک DAO جعلی به Repository ارسال کرد. متدهای عمومی Repository از زبان دامنه (مانند `save`, `observeNotes`) به جای زبان پایگاه داده (مانند `upsert`, `observeAll`) استفاده میکنند تا جزئیات Room به سایر بخشهای اپلیکیشن نفوذ نکند.
پایگاه داده باید دقیقاً یک بار در هر فرایند اپلیکیشن ایجاد شود، زیرا باز کردن SQLite یک عملیات گرانقیمت است و نمونههای متعدد میتوانند با یکدیگر تداخل داشته باشند. یک راه متداول برای انجام این کار بدون استفاده از فریمورکهای Dependency Injection، استفاده از یک زیرکلاس سفارشی `Application` است. کلاس `NotesApp` از `android.app.Application` ارثبری میکند و به عنوان خانه طبیعی برای Singletonهای سراسر اپلیکیشن عمل میکند. `by lazy` اطمینان حاصل میکند که پایگاه داده تنها زمانی ایجاد میشود که `repository` برای اولین بار فراخوانی شود، که به سرعت بخشیدن به راهاندازی اپلیکیشن کمک میکند. برای استفاده از این کلاس سفارشی، باید آن را در فایل `AndroidManifest.xml` با افزودن ویژگی `android:name=”.NotesApp”` به تگ `
ساخت رابط کاربری و ناوبری با Jetpack Compose
در دنیای پویای توسعه اپلیکیشنهای اندروید، Jetpack Compose به ابزار اصلی برای ساخت رابط کاربری بومی تبدیل شده است. این رویکرد مدرن که جایگزین سیستم Viewهای مبتنی بر XML شده، فرآیند توسعه را سادهتر و کارآمدتر میکند. هدف این بخش، بررسی دقیق چگونگی ساخت رابط کاربری و پیادهسازی سیستم ناوبری با Jetpack Compose و Navigation 3 است، که به شما امکان میدهد اپلیکیشنهایی با **تجربه کاربری** روان و واکنشگرا ایجاد کنید.
مبانی Jetpack Compose: رویکردی نو در ساخت رابط کاربری
Jetpack Compose با پارادایم “رابط کاربری تابعی از وضعیت است” (UI is a function of state) عمل میکند. به جای دستکاری مستقیم عناصر بصری، شما توابع @Composable را مینویسید که نحوه نمایش صفحه را بر اساس دادههای فعلی توصیف میکنند. هرگاه دادهها تغییر کنند، Compose تابع شما را با دادههای جدید مجدداً فراخوانی میکند و تنها بخشهایی از صفحه که واقعاً تغییر کردهاند، بهروزرسانی میشوند؛ این فرآیند “بازترکیب” (recomposition) نامیده میشود.
برای مدیریت وضعیت (state) در Compose، مفاهیم کلیدی وجود دارد:
rememberوmutableStateOf: برای نگه داشتن مقادیر وضعیت در طول بازترکیبها استفاده میشوند.rememberSaveable: وضعیت را حتی در برابر تغییرات پیکربندی مانند چرخش گوشی که باعث از بین رفتن و بازسازی فعالیت میشود، حفظ میکند.ViewModel: برای مدیریت وضعیتهای پیچیدهتر، بهویژه دادههایی که از پایگاه داده بارگذاری میشوند، ایدهآل است. ViewModel از طول عمر Activity بیشتر است و تضمین میکند که دادهها در چرخش صفحه یا سایر تغییرات پیکربندی از بین نمیروند.
یکی دیگر از اصول اساسی، “بالا بردن وضعیت” (state hoisting) است. در این الگو، کامپوزابلها وضعیت خود را به عنوان پارامتر دریافت میکنند و رویدادها را به عنوان لامبدا (callbacks) به بیرون ارسال میکنند. این رویکرد کامپوزابلها را قابل استفاده مجدد و تستپذیرتر میکند، و به شما امکان میدهد منطق وضعیت را در لایههای بالاتر، مانند ViewModel، متمرکز کنید. این اصل به ویژه در توسعه **افزونهها** و **قالبهای** یک سیستم **مدیریت محتوا**، برای افزایش پایداری و نگهداریپذیری کد، حیاتی است.
طراحی و پیادهسازی صفحات کاربردی: لیست و ویرایشگر
برای ساخت صفحات اپلیکیشن یادداشتبرداری، از دو کامپوزابل اصلی استفاده میشود: یک کامپوزابل NoteListScreen که وضعیتمدار است و به ViewModel متصل میشود، و یک کامپوزابل NoteListContent که بیوضعیت است و تنها مسئول نمایش اطلاعات است. NoteListScreen با استفاده از collectAsStateWithLifecycle() جریان دادهها (StateFlow) را به وضعیت Compose تبدیل میکند، که این کار به بهینهسازی مصرف باتری کمک میکند، زیرا زمانی که برنامه در پسزمینه قرار دارد، جمعآوری دادهها متوقف میشود.
در داخل NoteListContent، از Scaffold برای ارائه یک ساختار Material 3 شامل نوار بالای صفحه (top app bar) و دکمه شناور اکشن (floating action button) استفاده میشود. برای نمایش لیست یادداشتها، LazyColumn به کار گرفته میشود که تنها ردیفهای قابل مشاهده را رندر میکند و عملکردی مشابه RecyclerView در سیستمهای قدیمیتر دارد. هر یادداشت نیز توسط یک NoteCard جداگانه نمایش داده میشود که از Modifierها برای تنظیم رفتار و ظاهر خود استفاده میکند، مانند fillMaxWidth() برای پر کردن عرض کامل و clickable() برای واکنش به ضربه. استفاده صحیح از contentDescription در آیکونها نیز برای دسترسیپذیری و پشتیبانی از TalkBack ضروری است و یک **تجربه کاربری** فراگیر را تضمین میکند.
صفحه ویرایشگر NoteEditorScreen نیز با استفاده از rememberSaveable وضعیت محلی ورودیهای کاربر (عنوان و متن یادداشت) را حفظ میکند. LaunchedEffect برای بارگذاری یادداشتهای موجود هنگام ورود به صفحه یا تغییر noteId به کار میرود. OutlinedTextFieldها کامپوننتهای ورودی متن Material 3 هستند و imePadding() فضای مورد نیاز برای کیبورد مجازی را فراهم میکند تا محتوا پنهان نشود. دکمه برگشت از آیکونهای AutoMirrored استفاده میکند که به صورت خودکار در زبانهای راست به چپ (مانند فارسی) منعکس میشوند و به بهبود کلی **تجربه کاربری** در سطوح جهانی کمک میکند.
مدیریت ناوبری در برنامههای اندروید با Navigation 3
Navigation 3 یک کتابخانه ناوبری مدرن و کامپوزابل-محور از تیم Jetpack است که رویکرد متفاوتی نسبت به کتابخانههای قبلی دارد. در این سیستم، پشته ناوبری (back stack) به عنوان یک لیست ساده در نظر گرفته میشود که توسعهدهنده مالک آن است و ناوبری به معنای افزودن یا حذف آیتمها از این لیست است. کتابخانه با مشاهده این لیست، صفحه مربوط به کلید بالای پشته را نمایش میدهد.
برای تعریف مقاصد ناوبری، از NavKeys.kt استفاده میشود که هر مقصد را به عنوان یک نوع NavKey (مانند NoteList یا NoteEditor(id)) تعریف میکند. استفاده از @Serializable بر روی این کلیدها امکان ذخیره پشته ناوبری و بازیابی آن را فراهم میکند، حتی اگر اندروید برنامه را در پسزمینه از بین ببرد.
کلاس MainActivity به عنوان میزبان اصلی رابط کاربری Compose عمل میکند و enableEdgeToEdge() را برای نمایش تمامصفحه فعال میسازد. در QuickNotesNavHost، با استفاده از rememberNavBackStack(NoteList) یک پشته ناوبری قابل ذخیره ایجاد میشود که با صفحه لیست شروع میشود. NavDisplay کلید بالای پشته را رندر میکند و بلوک entryProvider هر نوع کلید را به کامپوزابل مربوطه خود نگاشت میکند.
عملیات ناوبری بسیار ساده هستند: برای حرکت به جلو از backStack.add(...) و برای برگشت به عقب از backStack.removeLastOrNull() استفاده میشود. این سادگی و شفافیت در مدیریت پشته ناوبری، توسعهدهندگان را قادر میسازد تا کنترل کاملی بر جریان کاربری داشته باشند، که در مقایسه با سیستمهای قدیمیتر بسیار انعطافپذیرتر است. Navigation 3 همچنین از قابلیت “پیشبینی برگشت” (predictive back) پشتیبانی میکند که انیمیشن پیشنمایش صفحه قبلی را در هنگام ژست برگشت کاربر فراهم میکند و به غنای **تجربه کاربری** میافزاید.
آمادهسازی و امضای اپلیکیشن برای Google Play
پس از اتمام مراحل توسعه و اطمینان از عملکرد صحیح اپلیکیشن در محیطهای تستی، نوبت به آمادهسازی نهایی برای انتشار در Google Play میرسد. بیلدهای دیباگ تنها برای فرآیند توسعه مناسب هستند، اما برای عرضه عمومی و نصب توسط کاربران واقعی، باید ملاحظات ویژهای را در نظر گرفت. این مرحله شامل تنظیمات مربوط به بیلد نهایی، تولید و مدیریت کلیدهای امضا، و ساخت بستههای انتشار است که همگی برای اطمینان از امنیت، بهینگی، و مطابقت با الزامات Google Play ضروری هستند.
مراحل نهایی پیش از انتشار اپلیکیشن
پیش از اینکه اپلیکیشن شما آماده آپلود شود، چندین مورد حیاتی وجود دارد که باید به آنها رسیدگی کنید تا کیفیت و استانداردهای Google Play را برآورده سازید:
-
آیکون پیشفرض اپلیکیشن را جایگزین کنید: قالبهای اولیه اندروید استودیو با آیکون عمومی اندروید ارائه میشوند. ضروری است که یک آیکون تطبیقپذیر (adaptive icon) طراحی و جایگزین کنید. Image Asset Studio در اندروید استودیو این امکان را فراهم میکند که آیکونی با لایههای پیشزمینه و پسزمینه جداگانه بسازید تا لانچرها بتوانند آن را در اشکال مختلف (دایره، مربع و غیره) ماسک کنند. همچنین، ارائه یک لایه تکرنگ (monochrome layer) برای اندروید ۱۳ و نسخههای جدیدتر، که از آیکونهای تمدار (themed icons) پشتیبانی میکنند، حائز اهمیت است.
-
رشتههای متنی هاردکد شده را به منابع منتقل کنید: برای حفظ قابلیت خوانایی کد در مراحل اولیه، ممکن است از رشتههای متنی هاردکد شده (مانند “Quick Notes”) استفاده کرده باشید. اما در یک اپلیکیشن واقعی، تمامی این رشتهها باید به فایل
res/values/strings.xmlمنتقل شوند. این کار امکان ترجمه اپلیکیشن به زبانهای مختلف را فراهم میکند، زیرا اندروید بهطور خودکار فایلstrings.xmlمناسب با زبان کاربر را انتخاب میکند. اندروید استودیو با هشدار Lint و قابلیت اصلاح سریع “Extract string resource” میتواند در این زمینه به شما کمک کند. -
بیلد ریلیز را با R8 بررسی کنید: با فعالسازی
isMinifyEnabledدر نوع بیلد ریلیز، کامپایلر R8 فعال میشود. R8 کدهای استفادهنشده را حذف، نام کلاسها و متدها را کوتاه، و کد باقیمانده را بهینه میکند. این فرآیند معمولاً حجم اپلیکیشن را بهطور قابلتوجهی کاهش داده و سرعت آن را افزایش میدهد. اما ممکن است کدی که بر بازتاب (reflection) متکی است را با مشکل مواجه کند، زیرا R8 نمیتواند استفاده از آن کلاس را بهطور مستقیم تشخیص دهد. کتابخانههایی مانند Room، Compose و kotlinx.serialization، قوانین keep مخصوص به خود را دارند، بنابراین اپلیکیشن شما نیاز به پیکربندی اضافی ندارد. با این حال، اگر کتابخانههایی با استفاده از reflection اضافه میکنید، مستندات آنها را برای افزودن قوانین بهproguard-rules.proبررسی کنید. ضروری است که یک بیلد ریلیز را قبل از آپلود اجرا کرده و تمامی صفحهها را تست کنید تا مشکلات احتمالی ناشی از R8 را شناسایی و رفع نمایید. -
مجوزهای غیرضروری را حذف کنید: مانیفست ادغامشده (Merged Manifest) خود را بررسی کنید و مجوزهای لیستشده را ببینید. برخی کتابخانهها ممکن است مجوزهایی را اضافه کنند که شما نیازی به آنها ندارید. هر مجوزی که اعلام میکنید باید در Play Console توجیه شود. اپلیکیشن یادداشتبرداری “Quick Notes” که همه چیز را بهصورت محلی ذخیره میکند، نیازی به هیچ مجوزی، حتی
INTERNETندارد. مجوزهای کمتر، فرآیند تکمیل فرم “Data safety” در Play Console را نیز سادهتر میکند.
ساخت کلید آپلود و امضای دیجیتال اپلیکیشن
هر اپلیکیشن اندروید باید قبل از نصب بهصورت رمزنگاریشده امضا شود. Google Play از سیستم دو کلیدی به نام Play App Signing استفاده میکند: شما آپلودهای خود را با یک کلید آپلود که خودتان ایجاد و نگهداری میکنید، امضا میکنید. گوگل آپلود را تأیید کرده، امضای شما را حذف و اپلیکیشن را با یک کلید امضای اپلیکیشن که در زیرساخت امن خود گوگل ذخیره شده است، مجدداً امضا میکند. کاربران نهایی فقط کلید امضای اپلیکیشن را مشاهده میکنند. مزیت این جداسازی در قابلیت بازیابی است: اگر کلید آپلود خود را از دست بدهید یا لو برود، میتوانید از گوگل بخواهید آن را از Play Console بازنشانی کند، و کاربران شما همچنان بهروزرسانیها را دریافت خواهند کرد. Play App Signing برای اپلیکیشنهای جدید اجباری است و همچنین امکان استفاده از Android App Bundle را فراهم میکند، زیرا گوگل برای تولید APKهای بهینه شده برای هر دستگاه، به کلید امضا نیاز دارد.
برای ایجاد یک کلید آپلود، میتوانید از ترمینال و ابزار keytool که همراه با JDK در اندروید استودیو ارائه میشود، استفاده کنید. این دستور یک فایل keystore جاوا با یک جفت کلید ایجاد میکند. مهم است که این فایل را در مکانی امن و خارج از پوشه پروژه خود ذخیره کرده و از آن بکآپ بگیرید. هرگز آن را در گیت (Git) کامیت نکنید. سپس، یک فایل keystore.properties در ریشه پروژه خود ایجاد کنید تا جزئیات امضا را در خود نگه دارد و سپس آن را در app/build.gradle.kts بارگذاری کرده و پیکربندی امضای ریلیز را ایجاد کنید. این فایلها باید بلافاصله به .gitignore اضافه شوند تا از اشتراکگذاری ناخواسته اطلاعات حساس جلوگیری شود.
ساخت Android App Bundle (AAB)
Google Play دیگر APKها را برای اپلیکیشنهای جدید نمیپذیرد؛ بهجای آن، باید یک Android App Bundle (AAB) آپلود کنید. یک باندل شامل تمام کدهای کامپایلشده و منابع شما برای هر تراکم صفحهنمایش، معماری CPU، و زبان است. هنگامی که کاربر اپلیکیشن را نصب میکند، Google Play یک APK تولید میکند که فقط شامل مواردی است که دستگاه خاص او نیاز دارد. بهعنوان مثال، یک گوشی با زبان انگلیسی و صفحهنمایش با تراکم بالا، رشتههای ژاپنی یا تصاویر با تراکم پایین را دانلود نمیکند، بنابراین حجم دانلود کمتر میشود.
برای ساخت باندل از ترمینال، دستور ./gradlew bundleRelease را اجرا کنید. این تسک نسخه ریلیز را کامپایل کرده، R8 را اجرا میکند، نتیجه را با کلید آپلود شما امضا میکند و باندل را در مسیر app/build/outputs/bundle/release/app-release.aab مینویسد. همچنین میتوانید از گزینه Build > Generate Signed App Bundle یا APK در اندروید استودیو استفاده کنید. قبل از آپلود، versionCode را برای هر بیلد جدیدی که به پلیاستور میفرستید، افزایش دهید. اولین آپلود میتواند از ۱ استفاده کند، بعدی باید ۲ یا بالاتر باشد و غیره. Google Play هر باندلی را که versionCode آن قبلاً دیده شده باشد، حتی در مسیر تستی متفاوت، رد میکند. versionName میتواند هر چیزی باشد، اما نسخههای سمانتیک (semantic versions) مانند 1.0.0، 1.0.1 و 1.1.0 برای کاربران و خود شما آسانتر است.
گام به گام تا انتشار در Google Play Store
توسعه اپلیکیشنهای اندروید با Jetpack Compose و Kotlin در سال ۲۰۲۶، نیازمند درک عمیقی از ابزارهای مدرن و فرآیند انتشار در Google Play است. این راهنما به شما کمک میکند تا یک اپلیکیشن نیتیو را از کدنویسی با Jetpack Compose تا انتشار موفق در بزرگترین بازار اپلیکیشنهای موبایل، هدایت کنید.
آمادهسازی و امضای اپلیکیشن
قبل از انتشار، اپلیکیشن شما باید برای نسخه نهایی آماده شود. این شامل بهروزرسانی آیکون (تطبیقپذیر و تکرنگ)، انتقال رشتههای ثابت به منابع (strings.xml) و تست بیلد ریلیز با R8 برای بهینهسازی کد است. حذف مجوزهای غیرضروری نیز فرمهای خطمشی پلی کنسول را سادهتر میکند.
هر اپلیکیشن اندرویدی برای نصب باید رمزنگاری و امضا شود. Google Play از سیستم Play App Signing استفاده میکند که شامل یک کلید آپلود (نزد شما) و یک کلید امضای اپلیکیشن (نزد گوگل) است. کلید آپلود را با keytool ایجاد و به صورت امن ذخیره کنید و اطلاعات آن را در keystore.properties برای Gradle قرار دهید. این سیستم در صورت از دست رفتن کلید آپلود، امکان بازنشانی آن را فراهم میکند.
ساخت Android App Bundle (AAB)
Google Play برای اپلیکیشنهای جدید، تنها Android App Bundle (AAB) را میپذیرد. AAB شامل تمام کدها و منابع اپلیکیشن برای معماریها و زبانهای مختلف است و گوگل پلی بر اساس نیاز دستگاه کاربر، نسخه بهینهشدهای از APK را تولید میکند که حجم دانلود را کاهش میدهد. برای ساخت باندل، از دستور bundleRelease در Gradle استفاده کنید. حتماً versionCode اپلیکیشن را قبل از هر آپلود جدید افزایش دهید.
راهاندازی حساب توسعهدهنده و ثبت اپلیکیشن
برای انتشار، ابتدا یک حساب توسعهدهنده در play.google.com/console ایجاد کرده و هزینه ۲۵ دلاری را پرداخت کنید. تکمیل تأیید هویت و مشخص کردن نوع حساب (شخصی/سازمانی) و وضعیت رایگان/پولی اپلیکیشن ضروری است. پس از آن میتوانید اپلیکیشن را در پلی کنسول ایجاد کنید.
تکمیل اطلاعات محتوایی و لیست فروشگاه
در بخش “App content”، باید به سوالاتی درباره اپلیکیشن خود پاسخ دهید. این شامل URL سیاست حفظ حریم خصوصی، اعلام نیاز به ورود به سیستم (با اعتبارنامه تست)، وجود تبلیغات و تکمیل پرسشنامه رتبهبندی محتوا است. فرم “Data safety” بسیار مهم است؛ در آن باید تمام دادههای جمعآوریشده توسط اپلیکیشن یا کتابخانههای شخص ثالث را به دقت اعلام کنید.
صفحه “Main store listing” شامل نام، توضیحات کوتاه (۸۰ کاراکتر و شامل کلمات کلیدی)، توضیحات کامل (۴۰۰۰ کاراکتر)، آیکون (۵۱۲x۵۱۲)، گرافیک ویژه (۱۰۲۴x۵۰۰) و اسکرینشاتها است. توضیحات باید طبیعی و جذاب باشند و اسکرینشاتهای با کیفیت در جذب کاربر بسیار موثرند.
اجرای تستها و انتشار نهایی
با تست داخلی شروع کنید، باندل AAB را آپلود کرده و لینک عضویت را با تسترها به اشتراک بگذارید تا از صحت کارکرد اپلیکیشن با Play App Signing اطمینان حاصل کنید. برای حسابهای توسعهدهنده شخصی، الزام به تکمیل “تست بسته” با حداقل ۱۲ تستر فعال به مدت ۱۴ روز متوالی برای کسب مجوز انتشار نهایی وجود دارد. از این دوره برای جمعآوری بازخورد و رفع اشکالات استفاده کنید. پس از تأیید گوگل، میتوانید اپلیکیشن خود را در مسیر تولید منتشر کنید و حتماً versionCode را افزایش دهید.
مدیریت بهروزرسانیها پس از راهاندازی
پس از انتشار، از “انتشار مرحلهای” (Staged Rollouts) استفاده کنید؛ ابتدا برای درصد کمی از کاربران منتشر کرده و نرخ خطاها را در Android vitals رصد کنید. حفظ targetSdk بهروز (که سالانه اجباری میشود) و برنامهریزی برای تغییرات پایگاه داده با ارائه Migration برای Room، برای اطمینان از تجربه کاربری بدون وقفه ضروری است.
جمعبندی و توصیه نهایی این مقاله
این راهنما فرآیند کامل ساخت و انتشار اپلیکیشن اندروید نیتیو با Jetpack Compose تا Google Play را پوشش داد. از آمادهسازی کد و امضای اپلیکیشن تا مدیریت دقیق مراحل در Google Play Console، هر گام حیاتی است. تأیید هویت، تکمیل صادقانه فرمهای خطمشی و اجرای موفقیتآمیز تستهای بسته برای حسابهای شخصی، کلید انتشار بدون مشکل هستند. با رعایت این نکات و بهروزرسانیهای مداوم، میتوانید اپلیکیشنی پایدار و موفق در بازار رقابتی اندروید داشته باشید.