انتقال دادن برنامه‌ها به Android 17

این سند نمای کلی از اقدامات توسعه و آزمایشی را ارائه می‌دهد که می‌توانید برای هم‌راستا شدن با خط زمانی انتشار پلاتفرم Android و اطمینان از تجربه کاربری یکپارچه در Android 17 انجام دهید.

با هر نسخه پخش Android، ویژگی‌های جدید و همچنین تغییرات رفتاری را معرفی می‌کنیم که هدفشان مفیدتر، ایمن‌تر، و کارآمدتر کردن Android است. در بسیاری از موارد، برنامه‌تان دقیقاً همان‌طور که انتظار می‌رود به‌صورت آماده‌به‌کار عمل خواهد کرد، درحالی‌که در موارد دیگر ممکن است لازم باشد برنامه‌تان را به‌روز کنید تا با تغییرات پلاتفرم سازگار شود.

کاربران می‌توانند به‌محض انتشار کد منبع در AOSP (پروژه منبع باز Android)، پلاتفرم جدید را دریافت کنند، بنابراین مهم است که برنامه‌های شما آماده باشند، عملکرد موردانتظار را برای کاربران داشته باشند، و در حالت ایده‌آل از ویژگی‌ها و میاناهای برنامه‌سازی کاربردی جدید بهره ببرند تا بیشترین استفاده را از پلاتفرم جدید داشته باشند.

یک انتقال معمولی دو فاز دارد که می‌توانند هم‌زمان باشند:

  • اطمینان از سازگاری برنامه (تا زمان انتشار نسخه نهایی Android 17)
  • هدف قرار دادن ویژگی‌ها و میاناهای برنامه‌سازی کاربردی پلاتفرم جدید (در اسرع وقت پس‌از انتشار نهایی)

اطمینان از سازگاری با Android 17

مهم است که عملکرد برنامه موجود خود را دربرابر Android 17 آزمایش کنید تا از تجربه عالی برای کاربرانی که به جدیدترین نسخه Android به‌روزرسانی می‌کنند اطمینان حاصل کنید. برخی‌از تغییرات پلاتفرم می‌تواند بر نحوه رفتار برنامه‌تان تأثیر بگذارد، بنابراین مهم است که زود و به‌طور کامل آزمایش کنید و هرگونه تنظیمات لازم را در برنامه‌تان انجام دهید.

معمولاً می‌توانید برنامه‌تان را اصلاح کنید و به‌روزرسانی را بدون نیاز به تغییر targetSdkVersion برنامه منتشر کنید. به‌طور مشابه، نباید نیازی به استفاده از میاناهای برنامه‌سازی کاربردی جدید یا تغییر compileSdkVersion برنامه باشد، هرچند این موضوع می‌تواند به نحوه ساخته شدن برنامه شما و عملکرد پلاتفرمی که استفاده می‌کند بستگی داشته باشد.

قبل‌از شروع آزمایش، حتماً با تغییرات رفتاری برای همه برنامه‌ها آشنا شوید. این تغییرات ممکن است بر برنامه‌تان تأثیر بگذارد، حتی اگر targetSdkVersion آن را تغییر ندهید.

دریافت Android 17

یک تصویر سیستم Android 17 را در دستگاه خود فلش کنید یا یک تصویر سیستم برای شبیه‌ساز Android بارگیری کنید.

بازبینی تغییرات

تغییرات رفتار سیستم را مرور کنید تا بخش‌هایی را که ممکن است برنامه‌تان تحت‌تأثیر قرار بگیرد شناسایی کنید.

آزمایش

برنامه را در دستگاه یا شبیه‌سازتان نصب کنید و آزمایش‌ها را اجرا کنید. روی تغییرات رفتار سیستم تمرکز کنید و همه جریان‌های برنامه را بررسی کنید.

به‌روزرسانی

فقط تغییرات کدی را اعمال کنید که برای سازگاری با تغییرات رفتاری یا حل مشکلات لازم است. با همان سطح میانای برنامه‌سازی کاربردی که برنامه‌تان در ابتدا هدف‌یابی کرده بود بازهمگردانی کنید - نیازی به هدف‌یابی Android 17 نیست.

انتشار

«دسته برنامه Android» یا APK به‌روزشده‌تان را امضا، بارگذاری، و منتشر کنید.

برنامه‌تان را برای سازگاری با Android 17 آزمایش کنید

در بیشتر موارد، آزمایش سازگاری با Android 17 شبیه آزمایش معمولی برنامه است. اکنون زمان خوبی برای مرور دستورالعمل‌های کیفیت برنامه اصلی و روال‌های مطلوب برای آزمایش است.

برای آزمایش، برنامه منتشرشده فعلی‌تان را در دستگاهی که Android 17 اجرا می‌کند نصب کنید و برای شناسایی مشکلات، جریان‌ها و عملکرد را بررسی کنید. برای متمرکز کردن آزمایش‌هایتان، تغییرات رفتاری برای همه برنامه‌ها را که در Android 17 معرفی شده‌اند و می‌توانند بر نحوه عملکرد برنامه‌تان تأثیر بگذارند یا باعث ازکارافتادن برنامه‌تان شوند مرور کنید.

همچنین حتماً استفاده از میاناهای غیرکیت توسعه نرم‌افزار محدودشده را بازبینی و آزمایش کنید. باید هر میانای محدودی را که برنامه‌تان استفاده می‌کند با کیت توسعه نرم‌افزار عمومی یا معادل کیت توسعه بومی جایگزین کنید. به هشدارهای logcat که این دسترسی‌ها را برجسته می‌کنند توجه کنید و از روش StrictMode detectNonSdkApiUsage() برای گرفتن آن‌ها به‌صورت برنامه‌نویسی‌شده استفاده کنید.

درنهایت، حتماً کتابخانه‌ها و کیت‌های توسعه نرم‌افزار را در برنامه‌تان به‌طور کامل آزمایش کنید تا مطمئن شوید که در Android 17 طبق انتظار کار می‌کنند و از روال‌های مطلوب برای حریم خصوصی، عملکرد، تجربه کاربری، مدیریت داده، و اجازه‌ها پیروی می‌کنند. اگر مشکلی پیدا کردید، سعی کنید به جدیدترین نسخه کیت توسعه نرم‌افزار به‌روزرسانی کنید یا برای دریافت راهنمایی با توسعه‌دهنده کیت توسعه نرم‌افزار تماس بگیرید.

وقتی آزمایش را تمام کردید و به‌روزرسانی‌ها را انجام دادید، توصیه می‌کنیم برنامه سازگارتان را فوراً منتشر کنید. این کار به کاربران شما امکان می‌دهد برنامه را زودتر آزمایش کنند و کمک می‌کند تا کاربران هنگام به‌روزرسانی به Android 17، انتقال روانی داشته باشند.

هدف‌یابی برنامه را به‌روز کنید و با میاناهای برنامه‌سازی کاربردی جدید بسازید

پس‌از انتشار نسخه سازگار برنامه‌تان، گام بعدی این است که با به‌روزرسانی targetSdkVersion و بهره‌برداری از میاناهای برنامه‌سازی کاربردی و قابلیت‌های جدید در Android 17، پشتیبانی کامل از Android 17 را اضافه کنید. هرزمان آماده بودید می‌توانید این به‌روزرسانی‌ها را انجام دهید، اما الزامات Google Play را برای هدف‌یابی پلاتفرم جدید درنظر داشته باشید.

هنگام برنامه‌ریزی برای پشتیبانی کامل از Android 17، تغییرات رفتاری را که بر برنامه‌های هدف Android 17 تأثیر می‌گذارند مرور کنید. این تغییرات رفتاری هدفمند ممکن است باعث مشکلات عملکردی شود که باید به آن‌ها رسیدگی کنید. در برخی موارد، این تغییرات به توسعه قابل‌توجهی نیاز دارد، بنابراین توصیه می‌کنیم هرچه زودتر با آن‌ها آشنا شوید و به آن‌ها رسیدگی کنید. برای کمک به شناسایی تغییرات رفتاری خاصی که بر برنامه‌تان تأثیر می‌گذارد، از کلیدهای سازگاری برای آزمایش برنامه‌تان با تغییرات انتخابی فعال‌شده استفاده کنید.

مراحل زیر نحوه پشتیبانی کامل از Android 17 را شرح می‌دهد.

دریافت کیت توسعه نرم‌افزار Android 17

برای ساختن با Android 17، جدیدترین نسخه پیش‌نمایش «استودیو Android» را نصب کنید. مطمئن شوید که دستگاه یا شبیه‌ساز Android 17 دارید.
targetSdkVersion و دیگر پیکربندی‌های ساخت را به‌روز کنید.

بازبینی تغییرات رفتار

تغییرات رفتاری را که برای برنامه‌هایی که Android 17 را هدف قرار می‌دهند اعمال می‌شود مرور کنید. بخش‌هایی را که ممکن است برنامه‌تان تحت‌تأثیر قرار بگیرد شناسایی کنید، و برای نحوه پشتیبانی از آن‌ها برنامه‌ریزی کنید.

بررسی تغییرات جدید حریم خصوصی

تغییرات لازم را در کد و معماری ایجاد کنید تا از تغییرات حریم خصوصی کاربر Android 17 پشتیبانی شود.

استفاده از ویژگی‌های Android 17

از میاناهای برنامه‌سازی کاربردی Android 17 برای افزودن ویژگی‌ها و قابلیت‌های جدید به برنامه‌هایتان استفاده کنید. برای Android 17 بازهمگردانی کنید.

آزمایش

در دستگاه یا شبیه‌ساز Android 17 آزمایش کنید. روی بخش‌هایی تمرکز کنید که تغییرات رفتاری ممکن است بر برنامه شما تأثیر بگذارد. عملکردی را که از میاناهای برنامه‌سازی کاربردی جدید استفاده می‌کند امتحان کنید. بازخورد درباره پلاتفرم و میانای برنامه‌سازی کاربردی ارائه دهید. هرگونه مشکل پلاتفرم، میانای برنامه‌سازی کاربردی، یا کیت توسعه نرم‌افزار طرف سوم را گزارش کنید.

به‌روزرسانی نهایی

وقتی میاناهای برنامه‌سازی کاربردی Android 17 نهایی شد، targetSdkVersion و دیگر پیکربندی‌های ساخت را دوباره به‌روز کنید، به‌روزرسانی‌های اضافی را انجام دهید، و برنامه‌تان را آزمایش کنید.

انتشار

«دسته برنامه Android» یا APK به‌روزشده‌تان را امضا، بارگذاری، و منتشر کنید.

دریافت کیت توسعه نرم‌افزار، تغییر هدف‌یابی، ساختن با میاناهای برنامه‌سازی کاربردی جدید

برای شروع آزمایش پشتیبانی کامل از Android 17، از جدیدترین نسخه پیش‌نمایش «استودیو Android» برای بارگیری Android 17 SDK و هر ابزار دیگری که نیاز دارید استفاده کنید. سپس، targetSdkVersion و compileSdkVersion برنامه‌تان را به‌روز کنید و برنامه را دوباره کامپایل کنید. برای جزئیات، به راهنمای راه‌اندازی کیت توسعه نرم‌افزار مراجعه کنید.

آزمایش کردن برنامه Android 17

پس‌از اینکه برنامه را کامپایل کردید و آن را در دستگاهی که Android 17 را اجرا می‌کند نصب کردید، آزمایش را شروع کنید تا مطمئن شوید برنامه هنگام هدف قرار دادن Android 17 به‌درستی کار می‌کند. برخی‌از تغییرات رفتاری فقط زمانی اعمال می‌شوند که برنامه شما پلاتفرم جدید را هدف قرار دهد، بنابراین بهتر است قبل‌از شروع، آن تغییرات را مرور کنید.

همانند آزمایش سازگاری پایه، همه جریان‌ها و عملکردها را برای پیدا کردن مشکلات بررسی کنید. آزمایش خود را روی تغییرات رفتاری برای برنامه‌هایی که Android 17 را هدف قرار می‌دهند متمرکز کنید. همچنین زمان خوبی است که برنامه‌تان را با دستورالعمل‌های کیفیت برنامه اصلی و روال‌های مطلوب برای آزمایش بررسی کنید.

حتماً استفاده از میاناهای غیرکیت توسعه نرم‌افزار محدودشده را که ممکن است اعمال شود بازبینی و آزمایش کنید. مراقب هشدارهای logcat باشید که این دسترسی‌ها را برجسته می‌کنند و از روش StrictMode detectNonSdkApiUsage() برای گرفتن آن‌ها به‌صورت برنامه‌نویسی‌شده استفاده کنید.

درنهایت، حتماً کتابخانه‌ها و کیت‌های توسعه نرم‌افزار را در برنامه‌تان به‌طور کامل آزمایش کنید تا مطمئن شوید که در Android 17 طبق انتظار کار می‌کنند و از روال‌های مطلوب برای حریم خصوصی، عملکرد، تجربه کاربری، مدیریت داده، و اجازه‌ها پیروی می‌کنند. اگر مشکلی پیدا کردید، سعی کنید به جدیدترین نسخه کیت توسعه نرم‌افزار به‌روزرسانی کنید یا برای دریافت راهنمایی با توسعه‌دهنده کیت توسعه نرم‌افزار تماس بگیرید.

آزمایش بااستفاده از کلیدهای سازگاری برنامه

Android 17 شامل کلیدهای سازگاری است که آزمایش کردن برنامه را با تغییرات رفتاری هدفمند آسان‌تر می‌کند. برای برنامه قابل‌اشکال‌زدایی، کلیدهای روشن/خاموش به شما امکان می‌دهند:

  • تغییرات هدف‌یابی‌شده را بدون تغییر واقعی targetSdkVersion برنامه آزمایش کنید. می‌توانید از کلیدهای تغییر وضعیت برای فعال‌سازی اجباری تغییرات رفتاری هدفمند خاص استفاده کنید تا تأثیر آن را بر برنامه موجودتان ارزیابی کنید.
  • آزمایش را فقط روی تغییرات خاصی متمرکز کنید. به‌جای اینکه مجبور باشید همه تغییرات هدف‌یابی‌شده را به‌طور هم‌زمان اعمال کنید، کلیدهای روشن/خاموش به شما امکان می‌دهند همه تغییرات هدف‌یابی‌شده را غیرفعال کنید، به‌جز تغییراتی که می‌خواهید آزمایش کنید.
  • مدیریت کلیدهای روشن/خاموش ازطریق adb. می‌توانید از فرمان‌های adb برای فعال و غیرفعال کردن تغییرات قابل‌تغییر در محیط آزمایش خودکارشده استفاده کنید.
  • بااستفاده از شناسه‌های تغییر استاندارد، سریع‌تر اشکال‌زدایی کنید. هریک از تغییرات قابل‌فعال/غیرفعال کردن دارای شناسه و نام یکتایی است که می‌توانید از آن برای اشکال‌زدایی سریع علت ریشه‌ای در خروجی گزارش استفاده کنید.

وقتی برای تغییر هدف‌یابی برنامه‌تان آماده می‌شوید یا وقتی درحال توسعه فعال برای پشتیبانی از Android 17 هستید، این کلیدهای یک‌وضعتی می‌توانند کمک کنند. برای اطلاعات بیشتر، تغییرات چارچوب همسازی (Android 17) را ببینید.