شروع کنید

با نحوه آماده کردن محیط توسعه نرم‌افزار برای کار با «کتابخانه اتصال داده»، ازجمله پشتیبانی از کد اتصال داده در Android Studio، آشنا شوید.

«کتابخانه اتصال داده» هم انعطاف‌پذیری و هم سازگاری گسترده‌ای ارائه می‌دهد—این کتابخانه پشتیبانی است، بنابراین می‌توانید از آن در دستگاه‌های دارای Android 4.0 (سطح میانای برنامه‌سازی کاربردی ۱۴) یا بالاتر استفاده کنید.

توصیه می‌کنیم از جدیدترین افزایه Android Gradle در پروژه‌تان استفاده کنید. بااین‌حال، اتصال داده در نسخه ۱.۵.۰ و بالاتر پشتیبانی می‌شود. برای اطلاعات بیشتر، با نحوه به‌روزرسانی افزایه Android Gradle آشنا شوید.

محیط ساخت

برای شروع به کار با اتصال داده، کتابخانه را از مخزن پشتیبانی در مدیر کیت توسعه نرم‌افزار Android بارگیری کنید. برای اطلاعات بیشتر، به‌روزرسانی IDE و ابزارهای کیت توسعه نرم‌افزار را ببینید.

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

android {
    ...
    buildFeatures {
        dataBinding true
    }
}

پشتیبانی «استودیو Android» از اتصال داده

«استودیو Android» از بسیاری از ویژگی‌های ویرایش برای کد اتصال داده پشتیبانی می‌کند. برای مثال، از ویژگی‌های زیر برای عبارت‌های اتصال داده پشتیبانی می‌کند:

• برجسته کردن نحو
• پرچم‌گذاری خطاهای نحوی زبان عبارت
• تکمیل کد XML
• ارجاع‌ها، ازجمله پیمایش—مانند پیمایش به یک اعلان—و اسناد سریع

اگر مقدار پیش‌فرض عبارت‌های اتصال داده ارائه شده باشد، قاب پیش‌نمایش در ویرایشگر چیدمان آن را نمایش می‌دهد. برای مثال، قاب پیش‌نمایش مقدار my_default را در ابزاره TextView که در مثال زیر اعلام شده است نمایش می‌دهد:

<TextView android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="@{user.firstName, default=my_default}"/>

اگر لازم است مقدار پیش‌فرضی را فقط درطول فاز طراحی پروژه‌تان نمایش دهید، می‌توانید به‌جای مقادیر عبارت پیش‌فرض، از مشخصه‌های tools استفاده کنید، همان‌طور که در مرجع مشخصه‌های Tools شرح داده شده است.