????? ?????? ???? ????? ?? ??????

نکات مهاجرت به AndroidX در اندروید استودیو :
غیرفعال بودن آیتم Use androidx.* artifacts به عنوان یادوآری برای توسعه طراحی اپلیکیشن در مشهد و گسترش دهندگان میباشد و مسلما در نسخه‌های آینده اندروید استودیو ، حذف خواهد شد.

در‌صورتی‌که می‌خواهید پروژه تازه در اندروید استودیو ایجاد کرد کنید ، کتابخانه جدید Appcompat در پروژه قرار دارد و هنگام اضافه کردن سایر کتابخانه‌های Support نیز پکیج‌های androidx در لیست نمایش داده می گردند.

ولی برای بروزرسانی پروژه‌های کهن ، هم به صورت دستی و هم با به کار گیری از قابلیتی که مختص همین زمینه در اندروید استودیو وجود دارد می‌توان اقدام کرد.

لینک های مفید برای تفحص بیشتر درباره اندروید ایکس :
لینک و پیوند مرور کلی AndroidX در اندروید استودیو

پیوند سفر به AndroidX در اندروید استودیو

لینک و پیوند کمکی تارنما استک اور فلو

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

۱ . مهاجرت به اندروید ایکس با بروزرسانی دستی :
برای سفر به اندروید ایکس به نحوه دستی احتمالا مجال زیادی را باید صرف کنیم.

پس از تغییر‌و تحول نام کتابخانه‌ها در build.gradle مربوط به ماژول نرم افزار بایستی import های مو جود در اکتیویتی‌ها نیز تصحیح شوند . به عنوان مثال :

import android.support.v7.app.AppCompatActivity;

باید با :

import androidx.appcompat.app.AppCompatActivity;

جایگزین شود. همچنین این تغییرات می بایست در تگ‌های لایه xml نیز انجام شود .

به عنوان مثال :

android.support.constraint.ConstraintLayout

با

androidx.constraintlayout.widget.ConstraintLayout

جایگزین می شود . علاوه بر آن باید دو خط تحت نیز به gradle.properties اضافه شود تا androidx فعال شود . طریق دستی برای مسافرت به androidx سفارش نمیشود.

android.useAndroidX=true

android.enableJetifier=true

خط اولیه یعنی useAndroidX مشخص می‌کند پلاگین اندروید از androidx بجای support به کار گیری نماید .

در خط بعد، پلاگین اندروید توسط enableJetifier به صورت خود کار با ویرایش دودویی (binary) کتابخانه‌های شخص سوم (کتابخانه‌هایی که توسط دیگران و مجموعه‌های غیر از دسته توسعه و گسترش اندروید منتشر میگردند) آنان را برای به کارگیری از androidx آماده می‌کند.

توجه : برای به کارگیری از androidx ورژن اندروید استودیو بایستی دستکم ۳٫۲ باشد . همچنین (compileSdkVersion و targetSdkVersion) نیز می بایست ۲۸ و به بالا باشد. درضمن از API 29 و به آن گاه فقط باید از androidx استفاده کرد .

۲ . مسافرت به اندروید ایکس با بروزرسانی خودکار :
از Android Studio ورژن ۳.۲ به آن گاه امکانی فراهم شده که پروژه‌های قبلی را بتوان به صورت اتومات و بدون نیاز به دستکاری دستی به پروژه‌ای بر پایه پکیج‌های androidx تبدیل کرد.

برای استفاده از این قابلیت بعداز گشودن پروژه در حوالی اندروید استودیو، در منوی Refactor آیتم Migrate to AndroidX را انتخاب فرمایید:

مهاجرت به اندروید ایکس در اندروید استودیو

بعد از تعیین این گزینه پیام زیر نمایش داده میشود :

در‌این پیغام توصیه شده قبل از استارت عملیات یک نسخه حمایت کننده (backup) از پروژه تهیه شود که به راحتی می‌توان پوشه مربوط به پروژه را در جایی دیگر ذخیره کرد .

همچنین خود اندروید استودیو مورد ای با عنوان Backup project as Zip file به انتهای این پنجره اضافه کرده که در صورت تایید ، یک بکاپ به صورت اتومات و با فرمت zip ایجاد کرد می‌شود .

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

در ابتدا محل ذخیره بکاپ پروژه را مشخص و معلوم می‌کنیم :

اندروید استودیو توضیحاتی از تغییرات پروژه برای مهاجرت به androidx را نمایش می دهد که با کلیک روی Do refactor تایید و عملیات ایفا میگردد :

نکات مهاجرت به AndroidX در اندروید استودیو :
غیرفعال بودن آیتم Use androidx.* artifacts به عنوان یادوآری برای توسعه طراحی اپلیکیشن در مشهد و گسترش دهندگان میباشد و مسلما در نسخه‌های آینده اندروید استودیو ، حذف خواهد شد.

در‌صورتی‌که می‌خواهید پروژه تازه در اندروید استودیو ایجاد کرد کنید ، کتابخانه جدید Appcompat در پروژه قرار دارد و هنگام اضافه کردن سایر کتابخانه‌های Support نیز پکیج‌های androidx در لیست نمایش داده می گردند.

ولی برای بروزرسانی پروژه‌های کهن ، هم به صورت دستی و هم با به کار گیری از قابلیتی که مختص همین زمینه در اندروید استودیو وجود دارد می‌توان اقدام کرد.

لینک های مفید برای تفحص بیشتر درباره اندروید ایکس :
لینک و پیوند مرور کلی AndroidX در اندروید استودیو

پیوند سفر به AndroidX در اندروید استودیو

لینک و پیوند کمکی تارنما استک اور فلو

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

۱ . مهاجرت به اندروید ایکس با بروزرسانی دستی :
برای سفر به اندروید ایکس به نحوه دستی احتمالا مجال زیادی را باید صرف کنیم.

پس از تغییر‌و تحول نام کتابخانه‌ها در build.gradle مربوط به ماژول نرم افزار بایستی import های مو جود در اکتیویتی‌ها نیز تصحیح شوند . به عنوان مثال :

import android.support.v7.app.AppCompatActivity;

باید با :

import androidx.appcompat.app.AppCompatActivity;

جایگزین شود. همچنین این تغییرات می بایست در تگ‌های لایه xml نیز انجام شود .

به عنوان مثال :

android.support.constraint.ConstraintLayout

با

androidx.constraintlayout.widget.ConstraintLayout

جایگزین می شود . علاوه بر آن باید دو خط تحت نیز به gradle.properties اضافه شود تا androidx فعال شود . طریق دستی برای مسافرت به androidx سفارش نمیشود.

android.useAndroidX=true

android.enableJetifier=true

خط اولیه یعنی useAndroidX مشخص می‌کند پلاگین اندروید از androidx بجای support به کار گیری نماید .

در خط بعد، پلاگین اندروید توسط enableJetifier به صورت خود کار با ویرایش دودویی (binary) کتابخانه‌های شخص سوم (کتابخانه‌هایی که توسط دیگران و مجموعه‌های غیر از دسته توسعه و گسترش اندروید منتشر میگردند) آنان را برای به کارگیری از androidx آماده می‌کند.

توجه : برای به کارگیری از androidx ورژن اندروید استودیو بایستی دستکم ۳٫۲ باشد . همچنین (compileSdkVersion و targetSdkVersion) نیز می بایست ۲۸ و به بالا باشد. درضمن از API 29 و به آن گاه فقط باید از androidx استفاده کرد .

۲ . مسافرت به اندروید ایکس با بروزرسانی خودکار :
از Android Studio ورژن ۳.۲ به آن گاه امکانی فراهم شده که پروژه‌های قبلی را بتوان به صورت اتومات و بدون نیاز به دستکاری دستی به پروژه‌ای بر پایه پکیج‌های androidx تبدیل کرد.

برای استفاده از این قابلیت بعداز گشودن پروژه در حوالی اندروید استودیو، در منوی Refactor آیتم Migrate to AndroidX را انتخاب فرمایید:

مهاجرت به اندروید ایکس در اندروید استودیو

بعد از تعیین این گزینه پیام زیر نمایش داده میشود :

در‌این پیغام توصیه شده قبل از استارت عملیات یک نسخه حمایت کننده (backup) از پروژه تهیه شود که به راحتی می‌توان پوشه مربوط به پروژه را در جایی دیگر ذخیره کرد .

همچنین خود اندروید استودیو مورد ای با عنوان Backup project as Zip file به انتهای این پنجره اضافه کرده که در صورت تایید ، یک بکاپ به صورت اتومات و با فرمت zip ایجاد کرد می‌شود .

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

در ابتدا محل ذخیره بکاپ پروژه را مشخص و معلوم می‌کنیم :

اندروید استودیو توضیحاتی از تغییرات پروژه برای مهاجرت به androidx را نمایش می دهد که با کلیک روی Do refactor تایید و عملیات ایفا میگردد :