این سند نمای کلی از مراحل معمول توسعه و آزمایش ارائه می‌دهد که می‌تواند به شما کمک کند برنامه‌ای برای آمادگی تهیه کنید که با خط زمان انتشار پلاتفرم همسو باشد و تجربه عالی برای کاربران شما در Android 16 تضمین کند.
با هر نسخه پخش Android، ویژگی‌های جدید و همچنین تغییرات رفتاری را معرفی می‌کنیم که هدفشان مفیدتر، ایمن‌تر، و کارآمدتر کردن Android است. در بسیاری از موارد، برنامه‌تان دقیقاً همان‌طور که انتظار می‌رود به‌صورت آماده‌به‌کار عمل خواهد کرد، درحالی‌که در موارد دیگر ممکن است لازم باشد برنامه‌تان را به‌روز کنید تا با تغییرات پلاتفرم سازگار شود.
کاربران می‌توانند به‌محض انتشار کد منبع در AOSP (پروژه منبع باز Android)، پلاتفرم جدید را دریافت کنند، بنابراین مهم است که برنامه‌های شما آماده باشند، عملکرد موردانتظار را برای کاربران داشته باشند، و در حالت ایده‌آل از ویژگی‌ها و میاناهای برنامه‌سازی کاربردی جدید بهره ببرند تا بیشترین استفاده را از پلاتفرم جدید داشته باشند.
یک انتقال معمولی دو فاز دارد که می‌توانند هم‌زمان باشند:
- اطمینان از سازگاری برنامه (تا زمان انتشار نسخه نهایی Android 16)
- هدف قرار دادن ویژگی‌ها و میاناهای برنامه‌سازی کاربردی پلاتفرم جدید (در اسرع وقت پس‌از انتشار نهایی)
اطمینان از سازگاری با Android 16
مهم است که عملکرد برنامه موجود خود را دربرابر Android 16 آزمایش کنید تا از تجربه عالی برای کاربرانی که به جدیدترین نسخه Android به‌روزرسانی می‌کنند اطمینان حاصل کنید. برخی‌از تغییرات پلاتفرم می‌تواند بر نحوه رفتار برنامه‌تان تأثیر بگذارد، بنابراین مهم است که زود و به‌طور کامل آزمایش کنید و هرگونه تنظیمات لازم را در برنامه‌تان انجام دهید.
معمولاً می‌توانید برنامه‌تان را اصلاح کنید و به‌روزرسانی را بدون نیاز به تغییر
targetSdkVersion برنامه منتشر کنید. به‌طور مشابه، نباید نیازی به استفاده از میاناهای برنامه‌سازی کاربردی جدید یا
تغییر compileSdkVersion برنامه باشد، هرچند این موضوع می‌تواند به نحوه ساخته شدن برنامه شما
و عملکرد پلاتفرمی که استفاده می‌کند بستگی داشته باشد.
قبل‌از شروع آزمایش، حتماً با تغییرات رفتاری برای همه برنامه‌ها آشنا شوید. این تغییرات ممکن است بر برنامه‌تان تأثیر بگذارد، حتی اگر
targetSdkVersion آن را تغییر ندهید.
یک ایمیج سیستم Android 16 را روی دستگاه خود فلش کنید، یا یک ایمیج سیستم برای شبیه‌ساز Android بارگیری کنید.
تغییرات رفتار سیستم را مرور کنید تا بخش‌هایی را که ممکن است برنامه‌تان تحت‌تأثیر قرار بگیرد شناسایی کنید.
برنامه را در دستگاه یا شبیه‌سازتان نصب کنید و آزمایش‌ها را اجرا کنید. روی تغییرات رفتار سیستم تمرکز کنید و همه جریان‌های برنامه را بررسی کنید.
فقط تغییرات کدی را اعمال کنید که برای سازگاری با تغییرات رفتاری یا حل مشکلات لازم است. با همان سطح میانای برنامه‌سازی کاربردی که برنامه‌تان در ابتدا هدف‌یابی کرده بود بازهمگردانی کنید - نیازی به هدف‌یابی Android 16 نیست.
«دسته برنامه Android» یا APK به‌روزشده‌تان را امضا، بارگذاری، و منتشر کنید.
انجام آزمایش سازگاری
در بیشتر موارد، آزمایش سازگاری با Android 16 شبیه آزمایش برنامه معمولی است. اکنون زمان خوبی برای مرور دستورالعمل‌های کیفیت برنامه اصلی و روال‌های مطلوب برای آزمایش است.
برای آزمایش، برنامه منتشرشده فعلی‌تان را در دستگاهی که Android 16 دارد نصب کنید و همه جریان‌ها و عملکردها را بررسی کنید و به‌دنبال مشکلات احتمالی بگردید. برای کمک به شما در تمرکز بر آزمایش، تغییرات رفتاری را برای همه برنامه‌های معرفی‌شده در Android 16 که می‌توانند بر نحوه عملکرد برنامه شما تأثیر بگذارند یا باعث ازکارافتادن برنامه شما شوند، مرور کنید.
همچنین حتماً استفاده از میاناهای غیرکیت توسعه نرم‌افزار محدودشده را بازبینی و آزمایش کنید. باید هر میانای محدودی را که برنامه‌تان استفاده می‌کند با
کیت توسعه نرم‌افزار عمومی یا معادل کیت توسعه بومی جایگزین کنید. به هشدارهای logcat که این دسترسی‌ها را برجسته می‌کنند توجه کنید و از روش StrictMode detectNonSdkApiUsage() برای گرفتن آن‌ها به‌صورت برنامه‌نویسی‌شده استفاده کنید.
درنهایت، حتماً کتابخانه‌ها و کیت‌های توسعه نرم‌افزار را در برنامه‌تان به‌طور کامل آزمایش کنید تا مطمئن شوید که در Android 16 طبق انتظار کار می‌کنند و از روال‌های مطلوب برای حریم خصوصی، عملکرد، تجربه کاربری، مدیریت داده، و اجازه‌ها پیروی می‌کنند. اگر مشکلی پیدا کردید، سعی کنید به جدیدترین نسخه کیت توسعه نرم‌افزار به‌روزرسانی کنید یا برای دریافت راهنمایی با توسعه‌دهنده کیت توسعه نرم‌افزار تماس بگیرید.
وقتی آزمایش را تمام کردید و به‌روزرسانی‌ها را انجام دادید، توصیه می‌کنیم برنامه سازگارتان را فوراً منتشر کنید. این کار به کاربران شما امکان می‌دهد برنامه را زودتر آزمایش کنند و کمک می‌کند تا کاربران هنگام به‌روزرسانی به Android 16، گذار آرامی داشته باشند.
هدف‌یابی برنامه را به‌روز کنید و با میاناهای برنامه‌سازی کاربردی جدید بسازید
پس‌از انتشار نسخه سازگار برنامه‌تان، گام بعدی این است که با به‌روزرسانی targetSdkVersion
و بهره‌برداری از میاناهای برنامه‌سازی کاربردی و قابلیت‌های جدید در Android 16،
پشتیبانی کامل از Android 16 را اضافه کنید.
هرزمان آماده بودید می‌توانید این به‌روزرسانی‌ها را انجام دهید، اما الزامات Google Play را برای هدف‌یابی پلاتفرم جدید درنظر داشته باشید.
هنگام برنامه‌ریزی برای پشتیبانی کامل از Android 16، تغییرات رفتاری را که بر برنامه‌های هدف Android 16 تأثیر می‌گذارند مرور کنید. این تغییرات رفتاری هدفمند ممکن است باعث مشکلات عملکردی شود که باید به آن‌ها رسیدگی کنید. در برخی موارد، این تغییرات به توسعه قابل‌توجهی نیاز دارد، بنابراین توصیه می‌کنیم هرچه زودتر با آن‌ها آشنا شوید و به آن‌ها رسیدگی کنید. برای کمک به شناسایی تغییرات رفتاری خاصی که بر برنامه‌تان تأثیر می‌گذارد، از کلیدهای سازگاری برای آزمایش برنامه‌تان با تغییرات انتخابی فعال‌شده استفاده کنید.
مراحل زیر نحوه پشتیبانی کامل از Android 16 را شرح می‌دهد.
جدیدترین نسخه پیش‌نمایش Android Studio را برای ساختن با Android 16 نصب کنید. مطمئن شوید که دستگاه یا شبیه‌ساز Android 16 دارید.
targetSdkVersion و دیگر پیکربندی‌های ساخت را
به‌روز کنید.
تغییرات رفتاری را که برای برنامه‌هایی که Android 16 را هدف قرار می‌دهند اعمال می‌شود مرور کنید. بخش‌هایی را که ممکن است برنامه‌تان تحت‌تأثیر قرار بگیرد شناسایی کنید، و برای نحوه پشتیبانی از آن‌ها برنامه‌ریزی کنید.
تغییرات لازم را در کد و معماری ایجاد کنید تا از تغییرات حریم خصوصی کاربر Android 16 پشتیبانی شود.
از میاناهای برنامه‌سازی کاربردی Android 16 برای افزودن ویژگی‌ها و قابلیت‌های جدید به برنامه‌هایتان استفاده کنید. برای Android 16 بازهمگردانی کنید.
در دستگاه یا شبیه‌ساز Android 16 آزمایش کنید. روی بخش‌هایی تمرکز کنید که تغییرات رفتاری ممکن است بر برنامه شما تأثیر بگذارد. عملکردی را که از میاناهای برنامه‌سازی کاربردی جدید استفاده می‌کند امتحان کنید. بازخورد درباره پلاتفرم و میانای برنامه‌سازی کاربردی ارائه دهید. هرگونه مشکل پلاتفرم، میانای برنامه‌سازی کاربردی، یا کیت توسعه نرم‌افزار طرف سوم را گزارش کنید.
وقتی میاناهای برنامه‌سازی کاربردی Android 16 نهایی شد،
targetSdkVersion و دیگر پیکربندی‌های ساخت را دوباره به‌روز کنید،
به‌روزرسانی‌های اضافی را انجام دهید، و برنامه‌تان را آزمایش کنید.
«دسته برنامه Android» یا APK به‌روزشده‌تان را امضا، بارگذاری، و منتشر کنید.
دریافت کیت توسعه نرم‌افزار، تغییر هدف‌یابی، ساختن با میاناهای برنامه‌سازی کاربردی جدید
برای شروع آزمایش پشتیبانی کامل از Android 16، از جدیدترین
نسخه پیش‌نمایش «استودیو Android» برای بارگیری Android 16 SDK
و هر ابزار دیگری که نیاز دارید استفاده کنید. سپس، targetSdkVersion و compileSdkVersion برنامه‌تان را به‌روز کنید و برنامه را دوباره کامپایل کنید. برای جزئیات، به راهنمای راه‌اندازی کیت توسعه نرم‌افزار مراجعه کنید.
آزمایش کردن برنامه Android 16
پس‌از اینکه برنامه را کامپایل کردید و آن را در دستگاهی که Android 16 را اجرا می‌کند نصب کردید، آزمایش را شروع کنید تا مطمئن شوید برنامه هنگام هدف قرار دادن Android 16 به‌درستی کار می‌کند. برخی‌از تغییرات رفتاری فقط زمانی اعمال می‌شوند که برنامه شما پلاتفرم جدید را هدف قرار دهد، بنابراین بهتر است قبل‌از شروع، آن تغییرات را مرور کنید.
همانند آزمایش سازگاری پایه، همه جریان‌ها و عملکردها را برای پیدا کردن مشکلات بررسی کنید. آزمایش خود را روی تغییرات رفتاری برای برنامه‌هایی که Android 16 را هدف قرار می‌دهند متمرکز کنید. همچنین زمان خوبی است که برنامه‌تان را با دستورالعمل‌های کیفیت برنامه اصلی و روال‌های مطلوب برای آزمایش بررسی کنید.
حتماً استفاده از میاناهای غیرکیت توسعه نرم‌افزار محدودشده را که ممکن است اعمال شود بازبینی و آزمایش کنید. مراقب هشدارهای logcat باشید که این دسترسی‌ها را برجسته می‌کنند و از
روش StrictMode detectNonSdkApiUsage() برای گرفتن آن‌ها
به‌صورت برنامه‌نویسی‌شده استفاده کنید.
درنهایت، حتماً کتابخانه‌ها و کیت‌های توسعه نرم‌افزار را در برنامه‌تان به‌طور کامل آزمایش کنید تا مطمئن شوید که در Android 16 طبق انتظار کار می‌کنند و از روال‌های مطلوب برای حریم خصوصی، عملکرد، تجربه کاربری، مدیریت داده، و اجازه‌ها پیروی می‌کنند. اگر مشکلی پیدا کردید، سعی کنید به جدیدترین نسخه کیت توسعه نرم‌افزار به‌روزرسانی کنید یا برای دریافت راهنمایی با توسعه‌دهنده کیت توسعه نرم‌افزار تماس بگیرید.
آزمایش بااستفاده از کلیدهای سازگاری برنامه
Android 16 شامل کلیدهای سازگاری است که آزمایش برنامه شما را با تغییرات رفتاری هدفمند آسان‌تر می‌کند. برای برنامه قابل‌اشکال‌زدایی، کلیدهای روشن/خاموش به شما امکان می‌دهند:
- تغییرات هدف‌یابی‌شده را بدون تغییر واقعی targetSdkVersion برنامه آزمایش کنید. می‌توانید از کلیدهای تغییر وضعیت برای فعال‌سازی اجباری تغییرات رفتاری هدفمند خاص استفاده کنید تا تأثیر آن را بر برنامه موجودتان ارزیابی کنید.
- آزمایش را فقط روی تغییرات خاصی متمرکز کنید. به‌جای اینکه مجبور باشید همه تغییرات هدف‌یابی‌شده را به‌طور هم‌زمان اعمال کنید، کلیدهای روشن/خاموش به شما امکان می‌دهند همه تغییرات هدف‌یابی‌شده را غیرفعال کنید، به‌جز تغییراتی که می‌خواهید آزمایش کنید.
- مدیریت کلیدهای روشن/خاموش ازطریق adb. می‌توانید از فرمان‌های adb برای فعال و غیرفعال کردن تغییرات قابل‌تغییر در محیط آزمایش خودکارشده استفاده کنید.
- بااستفاده از شناسه‌های تغییر استاندارد، سریع‌تر اشکال‌زدایی کنید. هریک از تغییرات قابل‌فعال/غیرفعال کردن دارای شناسه و نام یکتایی است که می‌توانید از آن برای اشکال‌زدایی سریع علت ریشه‌ای در خروجی گزارش استفاده کنید.
وقتی برای تغییر هدف‌یابی برنامه‌تان آماده می‌شوید یا درحال توسعه فعال برای پشتیبانی از Android 16 هستید، این کلیدها می‌توانند کمک کنند. برای اطلاعات بیشتر، تغییرات چارچوب همسازی (Android 16) را ببینید.