لیست تغییرات کتابخانه ویرایش

شما در این صفحه می‌توانید از تغییرات هر نسخه کتابخانه چابک مطلع شوید. چابک برای نسخه‌گذاری از مدل 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 در تداخل با کتابخانه‌های دیگر

  • افزودن متدهای getUserAttributes و setUserAttributes

  • با قرار دادن کد زیر در فایل 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_REFERRER intent برای ترک استورهای غیر از گوگلی پلی:

<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>


ارتقا

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 را فراخوانی کنید.

نسخه ۲.۱۳.۰ - ۱۳۹۷/۰۶/۱۳

تغییرات

  • افزودن متد 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 را بیاورد.