diff options
Diffstat (limited to 'docs/html/tools/data-binding/guide.jd')
| -rw-r--r-- | docs/html/tools/data-binding/guide.jd | 70 |
1 files changed, 58 insertions, 12 deletions
diff --git a/docs/html/tools/data-binding/guide.jd b/docs/html/tools/data-binding/guide.jd index 71409e4..ec16c6b 100644 --- a/docs/html/tools/data-binding/guide.jd +++ b/docs/html/tools/data-binding/guide.jd @@ -2,15 +2,6 @@ page.title=Data Binding Guide page.tags="databinding", "layouts" @jd:body -<div class="wrap"> -<p class="caution" style="background-color:#fffdeb;"> -The <strong>Android Data Binding Library</strong> is available as a <strong>developer -preview</strong>. Expression syntax and behaviors may change prior to the full release -of the library, currently planned for Q3 2015. If you have feedback or want to report -issues, please use the <a href="https://code.google.com/p/android-developer-preview/">issue -tracker</a>. Stay tuned for more information about Data Binding and examples of how to use it. </a> -</p> -</div> <div id="qv-wrapper"> <div id="qv"> <h2> @@ -140,17 +131,72 @@ tracker</a>. Stay tuned for more information about Data Binding and examples of </div><!-- qv --> </div><!-- qv-wrapper --> - <p> This document explains how to use the Data Binding Library to write declarative layouts and minimize the glue code necessary to bind your application logic and layouts. </p> +<p>The Data Binding Library offers both flexibility and broad comnpatibility +— it's a support library, so you can use it with all Android platform +versions back to <strong>Android 2.1</strong> (API level 7+).</p> + +<p>Android Studio <strong>1.3.0-beta1</strong> or higher is required.</p> + +<h4>Beta release</h4> + +<div class="caution"> + <p>Please note that the Data Binding library is a <strong>beta release</strong>. + While Data Binding is in beta, developers should be aware of the following + caveats:</p> + <ul> + <li> + This is a beta release of the feature intended to generate developer + feedback. It might contain bugs, and it might not work for your use case, + so use it at your own risk. That said, we do want your feedback! Please + let us know what is or isn’t working for you using the <a + href="https://code.google.com/p/android-developer-preview/">issue + tracker</a>. + </li> + <li> + The Data Binding library beta release is subject to significant changes, + including those which are not source code compatible with your app. That is, + significant rework may be required to take updates to the library in the future. + </li> + <li> + Developers should feel free to publish apps built with the Data Binding + library beta release, with the caveats that the standard Android SDK and + Google Play terms of service apply, and it’s always a great idea to test your + app thoroughly when adopting new libraries or tools. + </li> + <li> + We’re just getting started with Android Studio support at this time. + Further Android Studio support will come in the future. + </li> + <li> + By using the Data Binding library beta release, you acknowledge these + caveats.</li> + </ul> +</div> + +<h2 id="build_environment"> + Build Environment +</h2> + +<p>To get started with Data Binding, download the library from the Support +repository in the Android SDK manager. </p> + +<p>Make sure you are using a compatible version of Android Studio. +The Data Binding plugin for Android Studio requires Android Studio <strong>1.3.0-beta1 +or higher</strong>.</p> <h2 id="build_environment"> Build Environment </h2> +<p>To get started with Data Binding, download the library from the Support repository in the Android SDK manager. </p> + +<p>Make sure you are using a <strong>compatible version of Android Studio</strong>. The Data Binding plugin for Android Studio requires <strong>Android 1.3.0-beta1 or higher</strong>.</p> + <p> <strong>Setting Up Work Environment:</strong> </p> @@ -391,7 +437,7 @@ ListItemBinding binding = DataBindingUtil.<em>inflate</em>(layoutInflater, R.lay <<strong>variable name="userList" type="List&lt;User>"</strong>/> </<strong>data</strong>> </pre> -<p class="note"> +<p class="caution"> <strong>Note</strong>: Android Studio does not yet handle imports so the autocomplete for imported variables may not work in your IDE. Your application will still compile fine and you can work around the IDE issue by @@ -771,7 +817,7 @@ android:text="@{@plurals/banana(bananaCount)}"</strong> Have an orange Have %d oranges -android:text="<strong>&commat{&commatplurals/orange(orangeCount, orangeCount)}</strong>" +android:text="<strong>@{@plurals/orange(orangeCount, orangeCount)}</strong>" </pre> <p> Some resources require explicit type evaluation. |