Release 0.5.0

Author: drewhamilton

CHANGELOG.md

@@ -1,5 +1,19 @@
 # CHANGELOG
 
+## 0.5.0
+_2020-07-14_
+
+**Breaking change**: Update DeferredDrawable.Resource's `transformations` constructor parameter to
+receive the resolving Context as a parameter. This breaks binary compatibility by removing
+constructors with a Function1 parameter in their signature (replaced by a Function2 parameter). This
+also breaks source compatibility for Java consumers but not for Kotlin consumers.
+
+Add `deferred-resources-view-extensions` to simplify use of Deferred Resources with Views. Basic
+extensions are provided for View, TextView, and ImageView.
+
+Add `DeferredColorWithAlpha` along with a corresponding `withAlpha` extension on `DeferredColor`, to
+make alpha transformations on unresolved `DeferredColor`s simple.
+
 ## 0.4.0
 _2020-06-23_
 

README.md

@@ -17,20 +17,13 @@ repository](https://oss.sonatype.org/#view-repositories;snapshots~browsestorage)
 
 ```groovy
 implementation "com.backbase.oss.deferredresources:deferred-resources:$version"
+implementation "com.backbase.oss.deferredresources:deferred-resources-view-extensions:$version"
 ```
 
 ## Use
 
-In the view layer, resolve a deferred resource to display it:
-```kotlin
-val text: DeferredText = viewModel.getText()
-val textColor: DeferredColor = viewModel.getTextColor()
-textView.text = text.resolve(context)
-textView.setTextColor(textColor.resolve(context))
-```
-
 In the logic layer, declare the resource values however you like, without worrying about their
-resolution:
+resolution or about Context:
 ```kotlin
 class LocalViewModel : MyViewModel {
     override fun getText(): DeferredText = DeferredText.Resource(R.string.someText)
@@ -43,6 +36,20 @@ class RemoteViewModel(private val api: Api) : MyViewModel {
 }
 ```
 
+In the view layer, resolve a deferred resource to display it:
+```kotlin
+val text: DeferredText = viewModel.getText()
+val textColor: DeferredColor = viewModel.getTextColor()
+textView.text = text.resolve(context)
+textView.setTextColor(textColor.resolve(context))
+```
+
+With view extensions, this is even simpler:
+```kotlin
+textView.setText(viewModel.getText())
+textView.setTextColor(viewModel.getTextColor())
+```
+
 ## License
 ```
 Copyright 2020 Backbase R&D, B.V.

RELEASING.md

@@ -3,7 +3,7 @@
  1. Make sure you're on the main branch.
  2. Change `ext.libraryVersion` in the root build.gradle to a non-SNAPSHOT version.
  3. Update CHANGELOG.md for the impending release.
- 4. If necessary, update README.md.
+ 4. If necessary, update README.md and docs/index.md.
  5. Commit (don't push) the changes with message "Release x.y.z", where x.y.z is the new version.
  6. Tag the commit `x.y.z`, where x.y.z is the new version.
  7. Change `ext.libraryVersion` in the root build.gradle to the next SNAPSHOT version.

build.gradle

@@ -39,7 +39,7 @@ buildscript {
 
 ext {
     publishGroup = 'com.backbase.oss.deferredresources'
-    libraryVersion = '0.5.0-SNAPSHOT'
+    libraryVersion = '0.5.0'
     minSdk = 14
     targetSdk = 29
     buildToolsVersion = '29.0.3'

docs/index.md

@@ -8,7 +8,7 @@ repository/configuration layers to remain ignorant of Android's Context.
 ## Example
 
 In the logic layer, declare the resource values however you like, without worrying about their
-resolution:
+resolution or about Context:
 ```kotlin
 // Resource/attribute-based text and color:
 class LocalViewModel : MyViewModel {
@@ -31,12 +31,20 @@ textView.text = text.resolve(context)
 textView.setTextColor(textColor.resolve(context))
 ```
 
+With view extensions, this is even simpler. The View's own Context is used to resolve any deferred
+resource types:
+```kotlin
+textView.setText(viewModel.getText())
+textView.setTextColor(viewModel.getTextColor())
+```
+
 ### Import
 
 To use Deferred Resources, add the library as a dependency to your Android module:
 
 ```groovy
 dependencies {
     implementation "com.backbase.oss.deferredresources:deferred-resources:$version"
+    implementation "com.backbase.oss.deferredresources:deferred-resources-view-extensions:$version"
 }
 ```