ورچر
آموزشهای پراکنده از دنیای برنامه نویسی اندروید
ایجاد راهنمای برنامه های اندرویدی با SpotLight
برنامه نویس : Wooplr (wooplr)
نسخه : 1.0
لایسنس : آپاچی نسخه 2.0
ساخته شده در : 1395/3/28
آپدیت شده در : 1395/3/28
تگ ها : راهنمای برنامه اندروید,راهنما با spotlight,استفاده از spotlight,ساخت راهنما برای اندروید
لینک کتابخانه
با گسترش برنامه ها بعضا امکاناتی ارائه می شوند که برای کاربران آشنا نست و نیاز مند معرفی می باشند. راهنمای برنامه ها سه روش کلی دارد.روش اول افزودن بصورت اینترو در اول برنامه می باشد که تجربه نشان داده کاربران بدون خواندن اینتروها رد می شوند. روش دوم افزودن راهنما به یکی از منو های برنامه می باشد که این حالت هم از لحاظ ux زیاد جذاب نیست . روش سوم افزودن راهنما در حین اجرای برنامه با استفاده از المان های بصری می باشد. این کتابخانه تابع روش سوم می باشد و با افکتهای جدید و زیبا می باشد.
این کتابخانه با برنامه های SDK 11 به بالا سازگار می باشد.
دستور زیر را به فایل build.gradle پروژه خود اضافه کنید و اجازه دهید اندروید استودیو کتابخانه را دانلود نماید.
allprojects {
repositories {
maven { url "https://jitpack.io" }
}
}
compile 'com.github.wooplr:Spotlight:1.0'
روش استفاده
به کدهای onCreate کلاسهای خود کد زیر را اضافه کنید.
new SpotlightView.Builder(this)
.setRevealAnimationDuration(400)
.enableRevalAnimation(isRevealEnabled)
.performClick(true)
.fadinTextDuration(400)
.headingTvColor(Color.parseColor("#eb273f"))
.headingTvSize(32)
.headingTvText("Love")
.subHeadingTvColor(Color.parseColor("#ffffff"))
.subHeadingTvSize(16)
.subHeadingTvText("Like the picture?\nLet others know.")
.setMaskColor(Color.parseColor("#dc000000"))
.setTarget(view)
.lineAnimDuration(400)
.lineAndArcColor(Color.parseColor("#eb273f"))
.dismissOnTouch(true)
.setUsageId(usageId)
.show();
شرح کد ها
نام تابع |
توضیح استفاده |
maskColor(int) |
رنگ پس زمینه لایه راهنما را مشخص می کند |
target(View) |
ویوی که می خواهید راهنما بر آن تمرکز کند را انتخاب می کند |
introAnimationDuration(long) |
زمان لود راهنما را مشخص می کند |
enableRevalAnimation(boolean) |
با دادن مقدار true و false می توانید افکت لود شدن راهنما را فعال و غیر فعال کنید. |
fadeinTextDuration(long) |
زمان اجرا انیمیشن نوشته ها را تنظیم می کند. |
headingTvSize(int) |
سایز عنوان متن را تنظیم می کند. |
headingTvColor(int) |
رنگ عنوان متن را تنظیم می کند |
headingTvText(CharSequence) |
متن عنوان را ست می کند |
subHeadingTvSize(int) |
سایز متن زیر عنوان را تنظیم میکند. |
subHeadingTvColor(int) |
رنگ متن زیرعنوان را تنظیم میکند |
subHeadingTvText(CharSequence) |
متن زیر عنوان را تنظیم میکند. |
setTypeface(Typeface) |
به متن راهنما فونت کاستوم ست می کند |
lineAndArcColor(int) |
رنگ خطوط راهنما را ست می کند |
lineAnimDuration(long) |
زمان نمایش انیمیشن خطوط را تنظیم می کند |
performClick(boolean) |
نمایش کلیک روی ویو فوکوس شده |
usageId(String) |
کد اختصاصی برای هر اسپات لایت - رقم دلخواه وارد کنید |
dismissOnTouch(boolean) |
بسته شدن لایه راهنما را با تاچ کردن فعال و غیرفعال می کند |