لیست تغییرات کتابخانه
                    ویرایش
                
                
                شما در این صفحه میتوانید از تغییرات هر نسخه کتابخانه چابک مطلع شوید. چابک برای نسخهگذاری از مدل Semantic Versioning استفاده میکند. برای آشنایی با این مدل این قسمت را مطالعه نمایید.
نسخه ۳.۵.۰ - ۱۳۹۹/۰۹/۰۴
تغییرات
- بهبود موارد امنیتی.
 
نسخه ۳.۴.۱ - ۱۳۹۹/۰۸/۲۴
تغییرات
- حل مشکل خطای ANR به هنگام دریافت شناسه تبلیغاتی
 
نسخه ۳.۴.۰ - ۱۳۹۹/۰۵/۱۳
تغییرات
- بهینهسازی قواعد و دیکشنری 
DexGuard - از این پس، برای سفارشیسازی صدای نوتیفیکیشن باید از 
androidChannelIdوandroidChannelNameدر پیلود نوتیفیکیشن استفاده کنید - از این پس چابک، نام اپراتور کاربر هم را برای آنالیتیکس شناسایی میکند
 - افزودن متد 
isLoggedInبرای تشخیص اینکه کاربر وارد حساب است یا مهمان 
نسخه ۳.۳.۱ - ۱۳۹۹/۰۳/۳۱
تغییرات
- افزودن تمپلیت جدید و بهبود یافته نوتیفیکیشن برای بقیه نسخههای اندروید (۶ به پایین)
 
نسخه ۳.۳.۰ - ۱۳۹۹/۰۳/۱۹
تغییرات
- افزودن تمپلت جدید و بهبود یافته نوتیفیکیشن برای اندروید ۷ به بالا (پشتیبانی از راستچین RTL، بهبود عنوان و نمایش کامل متن حین استفاده از تصویر نوتیفیکیشن)
 - برای استفاده از رنگ پیشفرض نوتیفیکیشن، کد زیر را در فایل 
AndroidManifest.xmlداخل تگ<Application>قرار دهید: 
<meta-data
	        android:name="com.adpdigital.push.client.default_notification_color"
	        android:resource="@color/green_color" />
نسخه ۳.۲.۱ - ۱۳۹۹/۰۲/۳۱
تغییرات
- حل مشکل کرش هنگام آپدیت توکن پوش
 - حل مشکل کالبک متد لاگین
 - حل مشکل کرش هنگام ارسال داده Install Referrer در DexGuard
 
نسخه ۳.۲.۰ - ۱۳۹۸/۱۲/۰۴
تغییرات
- بهبود مدیریت خطاهای توکن پوشنوتیفیکیشن
 - بهبود پیادهسازی متد 
publishEvent - اضافه شدن متد 
unsetUserAttributes - افزودن متد 
decrementUserAttributeبرای کاهش دادههای کمیتی کاربر - جلوگیری از Full Backup کتابخانه در اندرویدهای ۷ به بالا
 - بهبود روند بروزرسانی توکن پوشنوتیفیکیشن
 - بهبود نمایش رنگ LED در اندرویدهای بالاتر از ۷
 - بهبود پخش صدای نوتیفیکیشن شخصیسازی شده در اندرویدهای بالاتر از ۷
 - از این پس میتوانید آیکون کوچک نوتیفیکیشن را با قرار دادن کد زیر در فایل 
AndroidManifest.xmlو در تگApplicationبه چابک بدهید: 
<meta-data
            android:name="com.adpdigital.push.client.default_notification_icon"
            android:resource="@drawable/ic_notification_icon" />
نسخه ۳.۱.۳ - ۱۳۹۸/۱۱/۱۵
تغییرات
- بهبود عملکرد 
loginکاربر پس از فراخونی آن بعد از متدconfigureEnvirnonment 
نسخه ۳.۱.۲ - ۱۳۹۸/۱۰/۱۸
تغییرات
- پشتیبانی از تاریخ و ساعت برای مقادیری که در دیتای 
trackPurchaseارسال میکنید با استفاده از کلاسDatetimeکه در کتابخانه چابک موجود هست. 
نسخه ۳.۱.۱ - ۱۳۹۸/۱۰/۱۶
تغییرات
- برطرف شدن مشکل نصب دستگاه وقتی 
pushNotificationدر فایل تنظیمات غیرفعال باشد. - بهبود مدیریت اعلانها در ماژول React-Native
 - برطرف شدن مشکل نشت حافظه
 
نسخه ۳.۱.۰ - ۱۳۹۸/۰۹/۴
تغییرات
- برطرف شدن مشکل ارسال پیام چابک از طریق صندوق پیام
 - برطرف شدن مشکل کرش وقتی شناسه کاربری نامعتبر به متد 
loginارسال میشود. - برطرف شدن مشکل نشت حافظه
 - افزودن متد 
loginبا امضای جدید برای آگاهی از نتیجه عملیات ثبتنام کاربر. - دریافت پارامتر label با استفاده از فراخوانی متد 
setDeferredDataListener(DeferredDataListener)و پیادهسازی متدonReferralReceived(label). این پارامتر در لینک ترکر قرار میگیرد و جهت پیادهسازی فرآیند دعوت از دوستان در اپلیکیشنتان کاربرد دارد. - پشتیبانی از افزودن به مقادیر آرایهای که برای دادههای سفارشی کاربر استفاده کردهاید با فراخوانی متد 
addToUserAttributeArray(attributeKey, attributeValue). - پشتیبانی از حذف مقادیر آرایهای که برای دادههای سفارشی کاربر استفاده کردهاید با فراخوانی متد 
removeFromUserAttributeArray(attributeKey, attributeValue). - پشتیبانی از حذف دادههای سفارشی کاربر با فراخوانی متد 
unsetUserAttribute(attributeKey). - پشتیبانی از تاریخ و ساعت برای مقادیری که در رویدادها و دادههای سفارشی کاربر ارسال میکنید با استفاده از کلاس 
Datetimeکه در کتابخانه چابک موجود هست. - پشتیبانی از کلاس 
Bundleبرای ارسال اطلاعات در رویدادها و دادههای سفارشی کاربر. 
ارتقا
- منسوخ شدن متد 
setOnDeeplinkResponseListener(deeplinkResponseListener). به جای آن از متدsetDeferredDataListener(DeferredDataListener)استفاده کنید. 
نسخه ۳.۰.۰ - ۱۳۹۸/۰۷/۱۰
تغییرات
- افزودن متد 
configureEnvironmentبرای خودکارسازی مقداردهی SDK به کمک فایل Chabok.sandbox.json یا Chabok.production.json - از این به بعد قابلیتهای آنی (realtime) و پوش نوتیفیکیشن (pushNotification) به صورت پیشفرض در فایل Chabok.sandbox.json یا Chabok.production.json قابل تنظیم است.
 - افزودن متدهای 
loginبرای ثبت کاربر - افزودن متد 
logoutبرای تبدیل کاربر به مهمان - افزودن متد 
login(userId, userHash)به منظور احراز هویت سرور به سرور - تغییر از GCM به FCM
 - افزودن 
disableSdkبرای غیرفعال کردن SDK چابک - افزودن متد 
trackRevenue - افزودن پراپرتی 
logLevelبرای لاگ گرفتن در سطوح مختلف مانند (debug, warning, info, …) 
ارتقا
در صورتی که میخواهید نسخه خود را ارتقا دهید، حتما مستندات مهاجرت به نسخه ۳ چابک را مطالعه کنید.
- منسوخ شدن متد 
init، به جای آن از متدconfigureEnvironmentاستفاده کنید. - منسوخ شدن متد 
setDevelopment، به جای آن از متدconfigureEnvironmentاستفاده کنید. - منسوخ شدن متد 
setEnableRealtimeو مقدار قابلیت آنی (realtime) در فایل Chabok.production.json یا Chabok.sandbox.json قابل تنظیم است. - اگر میخواهید کلاس 
FirebaseMessagingServiceرا خودتان پیادهسازی کنید و تمایل دارید چابک نیز پوش نوتیفیکیشن را دریافت کند، لازم است که متدChabokFirebaseMessaging.refreshTokenدر متدonNewTokenکلاس فایربیس و متدChabokFirebaseMessaging.onMessageReceivedدر متدonMessageReceivedکلاس فایربیس فراخوانی شود. - حذف متدهای 
registerوunregister، به جای این دو از متدهایloginوlogoutاستفاده کنید. - حذف 
GCMReceiverاز AndroidManifest.xml - حذف متدهای 
setUserInfoوgetUserInfo - تغییر مقدار پیشفرض realtime به 
false - انتقال متد 
isChabokPushNotificationبه کلاسChabokFirebaseMessaging 
نسخه ۲.۱۸.۲ - ۱۳۹۸/۰۸/۱۳
تغییرات
- برطرف شدن مشکل وارنینگ unsafe cryptographic encryption patterns در پنل گوگل پلی هنگام آپلود فایل apk
 
نسخه ۲.۱۸.۱ - ۱۳۹۸/۰۶/۲۶
تغییرات
- بهبود تبدیل کاربر دائم (دارای حساب کاربری) به کاربر مهمان پس از خروج از حساب
 - حل مشکل وضعیت صفحه نمایش ریکت نیتیو
 
نسخه ۲.۱۸.۰ - ۱۳۹۸/۰۶/۱۲
تغییرات
- از این پس در نوتیفیکیشنهای ساده (بدون تصویر) از متن بلند پشتیبانی میشود.
 - از متد 
isChabokPushNotificationمیتوانید برای تشخیص نوتیفیکیشن چابک استفاده کنید. - با استفاده از کد زیر میتوانید سرویس آنی (real-time) چابک را غیر فعال کنید:
 
<application ... >
    <meta-data android:name="com.adpdigital.push.client.DISABLE_REALTIME" android:value="TRUE" />
<application />
ارتقا
- از این پس چابک فقط وظیفه نمایش نوتیفیکیشن خود را دارد و نوتیفیکیشنهای کتابخانههای دیگر را نمایش نمیدهد.
 
نسخه ۲.۱۷.۳ - ۱۳۹۸/۰۶/۰۹
تغییرات
- بهبود Proguard rules در استفاده از reflection
 - حل مشکل تغییر شبکه ریکت نیتیو (پیام خطا: 
BroadcastReceiver components are not allowed to register to receive intents) 
نسخه ۲.۱۷.۲ - ۱۳۹۸/۰۵/۱۴
تغییرات
- بهبود ثبت کاربر برای دستگاههایی که از play services پشتیبانی نمیکنند. (پس از نمایش هشدار)
 - افزودن متد 
setEnableAlertForNotSupportingGcmبرای مدیریت نمایش هشدار مربوط به عدم پشتیبانی از play services - بهبود دریافت آمار کلیک روی نوتیفیکیشن (اکشنها و رد کردن)
 - بهبود نمایش پوش خودکار مکانی (Geo-fence)
 - از این پس متد 
registerAsGuestشناسه مهمان (guestId) میگیرد. - از این پس push service چابک، از اجازه اجرا در 
Backgroundاندروید O پیروی می کند. - حالا حداقل طول 
userIdیک کاراکتر است. - افزودن متد 
(init(context, mainActivityClass, APP_ID, API_KEY, USERNAME, PASSWORD, SENDER_IDجدید با قابلیت اختیاری بودنSENDER_ID - حل مشکل دریافت 
advertisingIdاز دستگاههایی که OEM buildهای مختلفی دارند - حل مشکل کرش کردن دستگاههایی که 
androidIdندارند 
نسخه ۲.۱۷.۱ - ۱۳۹۸/۰۴/۱۰
تغییرات
- 
    
پشتیبانی متد
incrementUserAttributeاز آرایهای از اطلاعات کاربر - 
    
حل مشکل proguard در صورت
trueدادنminifyEnabled 
نسخه ۲.۱۷.۰ - ۱۳۹۸/۰۴/۰۲
تغییرات
- 
    
پشتیبانی از مقدار درآمد با استفاده از متد
trackPurchase - 
    
پشتیبانی از بازخورد نوتیفیکیشن (influence) به صورت مستقیم یا غیر مستقیم
 - 
    
پشتیبانی از دیپ لینک در صورت نداشتن اپلیکیشن (deferred deep linking) با متد
setOnDeeplinkResponseListener - 
    
افزودن متد
incrementUserAttributeبرای افزایش مقدار دادههای کمیتی کاربر - 
    
افزودن متد
setDefaultNotificationChannelبرای تغییر نام پیشفرض کانال نوتیفیکیشن (برای اندروید ۸ به بالا) - 
    
حل مشکل نمایش Summary نوتیفیکیشن در نوتیفیکیشن چند رسانهای
 - 
    
حل مشکل بسته نشدن نوتیفیکیشن پس از کلیک کاربر روی دکمه یک ریدایرکت
 - 
    
معرفی
notifDeliveryبرای اطلاع از مشاهده شدن نوتیفیکیشن (impression) - 
    
افزایش تعداد کاراکترهای قابل قبول در
userIdبه ۶۴ کاراکتر - 
    
افزودن متد
publishBackgroundبرای انتشار رویداد در بکگراند - 
    
حل مشکل proguard در تداخل با کتابخانههای دیگر
 - 
    
با قرار دادن کد زیر در فایل
AndroidManifest.xmlفقط نوتیفیکیشنهای چابک را نمایش دهید 
<meta-data android:name="com.adpdigital.push.client.SHOW_ONLY_CHABOK_NOTIFICATIONS" android:value="ENABLE" />
ارتقا
- 
    
جایگزین شدن متدهای
getUserInfoوsetUserinfoبا متدهایgetUserAttributesوsetUserAttributes - 
    
تغییر رفتار در متد
notificationOpenedدر دریافت دیتای نوتیفیکیشن و باز کردن اپلیکیشن 
نسخه ۲.۱۶.۰ - ۱۳۹۸/۰۲/۱۸
تغییرات
- 
    
پشتیبانی از R8 (کوتاه کننده کد گوگل)
 - 
    
پشتیبانی از دیپ لینک (deep link) و ریدایرکت (redirect) برای کلیک روی نوتیفیکیشن
 - 
    
افزودن متد
appWillOpenUrlبرای ارسال اطلاعات اتریبیوشن دیپ لینک - 
    
بهبود رصد رویداد برای پشتیبانی از کاربرانی که از vpn استفاده میکنند
 - 
    
افزودن آمار و آنالیتیکس برای کلیک روی نوتیفیکیشن (اکشنها و رد کردن (dismiss))
 - 
    
افزودن رویداد
notificationOpenedبرای دریافت اطلاعات کلیک روی نوتیفیکیشن (اکشنها و رد کردن (dismiss)) - 
    
حل مشکل متد
registerAsGuest - 
    
حل مشکل crash کردن
INSTALL_REFERRERبرای دستگاهایی که Google Play Services ندارند 
نسخه ۲.۱۵.۰ - ۱۳۹۸/۰۱/۲۱
تغییرات
- 
    
تغییر رفتار در متد
registerAsGuest(دیگر با هر بار فراخوانی کاربر جدید ایجاد نمیکند.) - 
    
حالا چابک 
osBuildو localeکاربر را برای آنالیتیکس جمعآوری میکند - 
    
افزودن متد
setDefaultTrackerبرای ترک کمپینهای نصب (Pre-Install Campaigns) - 
    
حل مشکل ارسال اطلاعات کاربر در متد
setUserInfo - 
    
پشتیبانی از advertisingId گوگل
 - 
    
پشتیبانی از
INSTALL_REFERRERintent برای ترک استورهای غیر از گوگلی پلی: 
<receiver
    android:name="com.adpdigital.push.ChabokReferrerReceiver"
    android:permission="android.permission.INSTALL_PACKAGES"
    android:exported="true">
       <intent-filter>
            <action android:name="com.android.vending.INSTALL_REFERRER" />
        </intent-filter>
</receiver>
ارتقا
- پشتیبانی از 
INSTALL_REFERRERبرای گوگل پلی استور: 
implementation 'com.android.installreferrer:installreferrer:1.0'
نسخه ۲.۱۴.۲ - ۱۳۹۷/۱۲/۱۳
تغییرات
- افزودن متد 
registerAsGuestبرای اپلیکیشنهایی که کاربر مهمان دارند یا میخواهند نصب با اولین بازدید شمرده شود (مانند سرویس ادجاست) 
نسخه ۲.۱۴.۱ - ۱۳۹۷/۱۰/۱۷
تغییرات
- بهبود تایید نصب
 - حل مشکل 
Apache HTTP legacyبرای API level 28 (اندروید ۹) - افزودن قابلیت تشخیص Build اپلیکیشن (
DebugیاRelease) 
نسخه ۲.۱۴.۰ - ۱۳۹۷/۰۸/۲۱
ارتقا
- انتقال دادههای کاستوم به کلید 
dataدر متدهایpublishEventوtrack 
نسخه ۲.۱۳.۴ - ۱۳۹۷/۰۸/۲۰
تغییرات
- حل مشکل پارس کردن 
idدر متدEventMessage - برگرداندن پورت محیط آزمایشی (Sandbox) به نسخه قدیمی آن
 
نسخه ۲.۱۳.۳ - ۱۳۹۷/۰۸/۱۹
تغییرات
- پشتیبانی از غیرفعالسازی نمایش badge برای اعلان (مشاهده نحوه استفاده )
 - تغییر رفتار در اعمال badge روی آیکون لانچر
 - حل مشکل جابهجایی مقدار 
idباidچابک در دیتای متدpublishEvent 
نسخه ۲.۱۳.۲ - ۱۳۹۷/۰۷/۰۸
تغییرات
- افزودن متدهای 
gpsVersionFoundوgpsVersionRequiredبرای دریافت نسخه Play Services کاربر - حل مشکل نمایش خطای 
play services not found - حذف به کار بردن bindService
 
نسخه ۲.۱۳.۱ - ۱۳۹۷/۰۶/۱۴
تغییرات
- افزودن متد 
setAutoResetBadgeبرای پاک کردن خودکار Badge و نوتیفیکیشنها 
` نکته:
مقدار پیشفرض این متدtrueاست، بنابراین اگر مقدارfalseرا قرار دهید برای پاک کردن دستی **Badge** و نوتیفیکیشن [باید متدresetBadge` را فراخوانی کنید.](https://doc.chabok.io/android/features.html#%D9%85%D8%AF%DB%8C%D8%B1%DB%8C%D8%AA-%D9%86%D8%B4%D8%A7%D9%86%D9%87%D8%A7)
نسخه ۲.۱۳.۰ - ۱۳۹۷/۰۶/۱۳
تغییرات
- افزودن متد 
trackبرای رصد تعامل کاربر - پشتیبانی از ledColor و smallIcon در نوتیفیکیشن
 - پشتیبانی پارامتر sound  در 
payloadنوتیفیکیشن از پسوند فایل (نام فایل sound را میتوانید در هر دو حالت با پسوند و بدون پسوند وارد کنید) - پشتیبانی آرایهای از تگها برای متدهای 
addTagوremoveTagدر overload جدید - بهبود register مجدد کاربر با تغییر 
userIdاز متدregister 
ارتقا
- تغییر پیشفرض متد 
publishEventبهlive 
نسخه ۲.۱۲.۱ - ۱۳۹۷/۰۵/۳۰
تغییرات
- حل مشکل نمایش نوتیفیکیشن در اندروید 8.1 برای 
buildToolsVersion>=26 
نسخه ۲.۱۲.۰ - ۱۳۹۷/۰۵/۲۹
تغییرات
- از این پس 
push serviceچابک، از اجازه اجرا درBackgroundاندروید O پیروی می کند. - حل مشکل نمایش پوش نوتیفیکیشن در 
targetSdkVersion >= 26 
ارتقا
- چابک پوشنوتفیکیشن دریافتی از FCM/GCM را در حالت 
foregroundنمایش میدهد. 
نسخه ۲.۱۱.۳ - ۱۳۹۷/۰۵/۱۶
تغییرات
- حل مشکل پخش صدای نوتیفیکیشن. (فایل صدای نوتیفیکیشن باید حتما در مقصد 
\raw\{FILENAME}.mp3قرار بگیرد. دقت کنید که درpayloadنوتیفیکیشن از پسوند استفاده نکنید.) 
نسخه ۲.۱۱.۲ - ۱۳۹۷/۰۴/۳۰
ارتقا
- افزودن قابلیت تشخیص وضوح تصویر
 - قابلیت تشخیص غیرفعال کردن پوش نوتیفیکیشن توسط کاربر 
DENIED - افزودن روش جدید برای قابلیت یکتا سازی دستگاه با کلید 
uniqueId 
نسخه ۲.۱۱.۱ - ۱۳۹۷/۰۳/۲۸
تغییرات
- افزودن قابلیت تغییر رنگ دکمههای نوتیفیکیشن چندرسانهای
 - نمایش 
bodyدر نوتیفیکیشن - تشخیص زمان نصب اپلیکیشن
 - تشخیص شناسه اپلیکیشن 
bundleIdentifier - تشخیص منبع نصب اپلیکیشن 
installerSource - حل مشکل متد 
unRegisterجهت پاک کردن کانالهای کاربر حذف شده 
نسخه ۲.۱۱.۰ - ۱۳۹۷/۰۳/۲۲
تغییرات
- پشتیبانی از نمایش تصویر در پوش نوتیفیکیشن
 - امکان اضافه کردن 
actionبه پوش نوتیفیکیشن 
نسخه ۲.۱۰.۳ - ۱۳۹۷/۰۲/۰۵
تغییرات
- حل مشکل متد 
unRegisterبا USER_ID،NULL 
نسخه ۲.۱۰.۲ - ۱۳۹۶/۱۱/۰۲
تغییرات
- رفع مشکل ارسال نسخه چابک
 - پشتیبانی از رویدادهای نصب جدید و باز شدن برنامه
 - پشتیبانی از عنوان و متن اعلان با استفاده از کلید نوتیفیکیشن (درون برنامهای و GCM)
 
نسخه ۲.۱۰.۱ - ۱۳۹۶/۱۰/۳۰
تغییرات
- رفع مشکل سازگاری با اندروید استودیو نسخه ۳ به پایین
 
نسخه ۲.۱۰.۰ - ۱۳۹۶/۱۰/۱۸
تغییرات
- حذف متد 
reRegister. - عدم اتصال مجدد پلتفرم چابک با روشن شدن صفحه گوشی.
 - بهبود مدیریت اتصال
 - افزودن متد 
hasProtectedAppSupport. با استفاده از این متد میتوان بررسی نمود آیا گوشی استفاده شده برنامه را در لیست protectedApp قرار میدهد یا خیر. - افزودن متد 
showProtectedAppSettingsبرای نمایش پیغام مربوط به برنامههای محافظت شده 
ارتقا
- مقدار پیشفرض برای حالت 
devModeوجود نداشت که برابرtrueدر نظر گرفته شد. - به جای متد 
reRegisterاز متدregisterاستفاده شود. 
نسخه ۲.۹.۱ - ۱۳۹۶/۰۹/۲۸
تغییرات
- افزودن متد 
addCallbackIntentبرای دسترسی به موقعیت مکانی در حالتkillوbackground 
نسخه ۲.۹.۰ - ۱۳۹۶/۰۹/۲۲
تغییرات
- در پیام چابک مقدار پیشفرض برای نام کانال برابر default و مقدار پیشفرض برای user مقدار * میباشد.
 - افرودن یک امضای جدید برای متد publish به صورت زیر:
 
public void publish(final String user, final String channel, final String text, final com.adpdigital.push.Callback clbk)
- افزودن متد 
unsubscribeEvent 
ارتقا
- عضویت در کانال عمومی به صورت 
CHANNEL_NAMEو در کانال خصوصی به صورتprivate/CHANNEL_NAMEامکان پذیر است. - متد 
getSubscriptionsلیست کانالها را بر اساس الگوی جدبد برمیگرداند. حذفامضای زیر از متد publish، بنابراین اگر بخواهید پیام چابک دارای مقدار دیتا باشد باید دیتای خود را به شکل json برای آن ست کنید و از امضایی که پیام چابک میگیرد استفاده نمایید.
public void publish(String channel, String text, JSONObject data, Callback clbk)
- تفییر نام متدهای 
set/getTopicNameبهset/getChannel - تغییر نام متد 
enableEventDeliveryبهsubscribeEvent - پارامتر سوم در متد 
publishEventازstatefulبهliveتغییر نمود 
public void publishEvent(final String event, final JSONObject data, final boolean live)
مدل نسخهگذاری در چابک (Semantic Versioning)
چابک از مدل نسخهگذاری MAJOR.MINOR.PATCH استفاده میکند. همه تغییرات نسخهها بلافاصله پس از انتشارشان به صورت موردی در صفحه لیست  تغییرات برای اطلاع شما اضافه میشوند. برای همین توصیه میکنیم این صفحه را حتما مطالعه نمایید. این موارد برای هر نسخه در دو بخش ارتقا (در صورت وجود ارتقا) و تغییرات برای شما نمایش داده شده است.
Patch:تغییرات در این سطح شامل Bug Fix و قابلیتهای بسیار کوچک میباشد. به روز رسانی به این نسخهها نیاز به تغییری در کد ندارد. برای آگاهی از آنها، باید بخش تغییرات را مطالعه کنید. به عنوان مثال به روز رسانی کتابخانه چابک از نسخه2.14.0به نسخه2.14.1مربوط به این سطح میشود.Minor:تغییرات در این سطح شامل قابلیتهای بزرگتر و تغییر در کارکرد (Functionality) کتابخانه میشود. در به روز رسانی به این نسخهها حتما باید بخش ارتقا و تغییرات صفحه لیست تغییرات را با دقت مطالعه کنید. در صورت بروز هر گونه مشکل در نتیجه رعایت نکردن نکات بخش ارتقا و تغییرات در به روز رسانی به نسخههای Minor، تیم چابک مسئولیتی را نمیپذیرد. توصیه میکنیم که هر سه تا شش ماه اقدام به بررسی نسخههای Minor نمایید. به عنوان مثال به روز رسانی کتابخانه چابک از نسخه2.12.1به نسخه2.14.1مربوط به این سطح میشود.Major:این سطح از تغییرات مخصوص بازنویسی و یا تغییرات اساسی در کتابخانه چابک است. در به روز رسانی به این نسخهها حتما باید بخش ارتقا و تغییرات تغییرات صفحه لیست تغییرات را با دقت مطالعه کنید. در صورت بروز هر گونه مشکل در نتیجه رعایت نکردن نکات بخش ارتقا و تغییرات در به روز رسانی به نسخههای Major، تیم چابک مسئولیتی را نمیپذیرد. بنابراین توصیه میکنیم که هر یک سال اقدام به بررسی نسخههای Major نمایید. به عنوان مثال بهروزرسانی کتابخانه چابک از نسخه1.0.1به نسخه2.14.1مربوط به این سطح میشود.
نکته:توصیه میکنیم برای دریافت آخرین نسخه Bug Fixها از کاراکتر + (wildcard) استفاده نمایید تا gradle به صورت خودکار نسخههای patch را بیاورد.