Advanced Permission manager کتابخانه ای است که توسط آن از شر تمامی دردسر های مجوز های درحال اجرای اندروید خلاص می شوید. همانطور که می دانید تعدادی مجوز در اندروید جزو مجوز های خطرناک است که برای استفاده از آنها علاوه بر منیفست باید در حال اجرا نیز اجازه کاربر را بگیرید و روند گوناگونی دارد. لیست مجوز های خطرناک به شرح ذیل است:

READ_CALENDAR
WRITE_CALENDAR
CAMERA
READ_CONTACTS
WRITE_CONTACTS
GET_ACCOUNTS
ACCESS_FINE_LOCATION
ACCESS_COARSE_LOCATION
RECORD_AUDIO
READ_PHONE_STATE
CALL_PHONE
READ_CALL_LOG
WRITE_CALL_LOG
ADD_VOICEMAIL
USE_SIP
PROCESS_OUTGOING_CALLS
BODY_SENSORS
SEND_SMS
RECEIVE_SMS
READ_SMS
RECEIVE_WAP_PUSH
RECEIVE_MMS
READ_EXTERNAL_STORAGE
WRITE_EXTERNAL_STORAGE

حال ممکن است کاربر نه تنها اجازه ندهد بلکه گزینه “دیگر نشان نده” را انتخاب کند و برای رسیدگی کردن به این قضیه، چک های مختلفی انجام داد که خوشبختانه کتابخانه Advanced Permission manager همه این موارد را به عهده می گیرد.

برای استفاده از این کتابخانه خط زیر را به گریدل برنامه اضافه کنید:

compile 'ir.mtajik.android:advancedPermissionsHandler:1.0.6'

کافی است  Activity خود را از PermissionHandlerActivity ارث بری کنید. سپس متد زیر را صدا کنید و دیگر نگران برسی کردن مجوز و مراحل دست و پا گیر آن نباشید. همه آن را کتابخانه بصورت اتومات مدیریت می کند.

String[] permissions = new String[] {Manifest.permission.SEND_SMS, 
Manifest.permission.WRITE_EXTERNAL_STORAGE , Manifest.permission.READ_EXTERNAL_STORAGE , ...}

boolean stickyMode = true;

askForPermission(permissions , stickyMode, new PermissionCallBack() {
                    
                    @Override
                    public void onPermissionsGranted() {  
                        Log.i("mahdi", "onPermissionsGranted: ");
                    }

                    @Override
                    public void onPermissionsDenied(String[] permissions) {
                        Log.i("mahdi", "onPermissionsDenied: ");
                    }
                });

روند گرفتن مجوز بدین شکل است:

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

حال stickyMode  مشخص می کند که تمام مراحل بالا در یک نشست اتفاق بیافتد یا اینکه خیر. استفاده از این کتابخانه باعث میشه که بدون نگرانی بابت مجوزها به قسمت های دیگر برنامه بپردازید. اگر درمورد پیاده سازی نکته، پیشنهاد، مشکل یا سوالی داشتید خوشحال می شم تا با من درمیان بگذارید.

لینک پروژه در Github

https://github.com/mahdit83/advancedSmsManager

لینک پروژه در Bintray

https://bintray.com/mahdi/maven/advancedsmsmanager

لینک در android-arsenal

https://android-arsenal.com/details/1/6024

منبع: بایت کد

نوشته کتابخانه Advanced Permission manager اولین بار در Mahdi Tajik پدیدار شد.

AdvancedSmsManager کتابخانه پیشرفته ای است وظیفه ارسال sms  در اندروید را می توانید بطور کامل به آن محول کنید. همچین امکان ارسال پیام کوتاه از گوشی های دو سیم کارته با امکان انتخاب از کاربر نیز وجود خواهد داشت. (این امکان برای sdk بالای ۲۱ قابل استفاده است و در گوشی های پایین تر از Lollipopo فعال نیست.) تلاشم در تهیه این کتابخانه محول کردن تمام امور به کتابخانه و فقط استفاده راحت از آن می باشد. در خود کتابخانه نیز تمامی بخش ها بصورت DI توسط Dagger2 پیاده سازی شده است.

برای استفاده از این کتابخانه خط زیر را در گریدل اپ بنویسید:

compile 'ir.mtajik.android:advancedsmsmanager:1.1.0'

کافیست به بیلدر کانتکست و شماره مقصد را بدهید، سپس می توانید از امکانات اختیاری به همراه with استفاده کنید. مثلا می توانید برای سیم کارت فیلتر بگذارید که مثلا فقط ایرانسل ارسال شود، همچنین دیالوگ های نمایشی به کاربر می تواند دیالوگ های پیش فرض برنامه باشد یا اینکه دیالوگ های شخصی شده شما.

برای استفاده فقط کافیست دستور زیر را اجار کنید:

SmsHandler.builder(context, "+989120000000")
                .withCarrierNameFilter("MCI")
                .withCustomDialogForSendSms(R.layout.my_sms_dialog)
                .withCustomDialogForChoseSim(R.layout.simcard_choosing_dialog)
                .needToShowDialog(false)
                .build().sendSms(DIALOG_MESSAGE, SMS_BODY, new MySmsManager.SMSManagerCallBack() {
            @Override
            public void afterSuccessfulSMS(int smsId) {

            }

            @Override
            public void afterDelivered(int smsId) {

            }

            @Override
            public void afterUnSuccessfulSMS(int smsId, String message) {

            }

            @Override
            public void onCarrierNameNotMatch(int smsId, String message) {

            }
        });

همانطور که ملاحظه می نمایید چهار تا کالبک خواهد داشت که شما می توانید اتفاقات مورد نظر بعد از هرکدام را زیر آن ها بنویسید.

afterSuccessfulSMS

بعد از ارسال موفقیت آمیز اس ام اس.

afterDelivered

بعد از اینکه پیام کوتاه به مقصد رسید چه اتفاقی بیافتد.

afterUnSuccessfulSMS

بعد از ناموفق بودن ارسال چه اتفاقی بیافتد. ( دلیل عدم موفقیت بصورت استرینگ قابل دسترس است)

onCarrierNameNotMatch

وقتی اتفاق می افتد که سیمکارت انتخاب شده با فیلتر داده شده مطابقت ندارد. ( برای sdk بالای ۲۱ قابل استفاده است)

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

Manifest.permission.SEND_SMS

Manifest.permission.READ_PHONE_STATE

لینک پروژه در Github

https://github.com/mahdit83/advancedSmsManager

لینک پروژه در Bintray

https://bintray.com/mahdi/maven/advancedsmsmanager

لینک در android-arsenal

https://android-arsenal.com/details/1/6024

منبع: بایت کد

نوشته کتابخانه Advanced Sms manager اولین بار در Mahdi Tajik پدیدار شد.