From 7a3165ac7404381eb85ea40525db1a7a7d980761 Mon Sep 17 00:00:00 2001 From: Allan Wang Date: Tue, 26 Dec 2017 04:01:23 -0500 Subject: Update/kpref activity (#113) * Revamp kpref * Clean up data * Fix script * Test emulator * Test google api * Test again * Test gpg * Update dependencies --- docs/Migration.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 docs/Migration.md (limited to 'docs/Migration.md') diff --git a/docs/Migration.md b/docs/Migration.md new file mode 100644 index 0000000..1d8cd9d --- /dev/null +++ b/docs/Migration.md @@ -0,0 +1,35 @@ +# Migrations + +Below are some highlights on major refactoring/breaking changes + +# v3.6.0 + +## startActivity + +Before, startActivity attempted to bind a lot of options with defaults. +Instead, we will now rely on the builder pattern so users may supply their own. +Attributes like `transition` have been replaced with bundle functions such as `withSceneTransitionAnimation(context)`. +The ordering of the builder functions have also been unified so that `bundleBuilder` is always before `intentBuilder`. + +## kpref-activity + +### Click Events + +Instead of passing parameters through the click functions, which were often unused, +they will now be provided through extensions from `KClick`. + +`KClick` holds the same values you'd expect (`itemView`, `innerView` (renamed), `item`), +and adds on `context` and is loaded lazily where possible. + +### Title Res + +In an attempt to make kprefs functional and thus easy to configure, +two new functions, `titleFun` and `descFun` have been introduced. +They will be triggered whenever kprefs are updated to get an up to date stringRes +based on whatever conditions you specify. Most conditions are passed through anyways, +which is why these functions supply no additional information. + +You are still free to use the original `descRes` +and the constructor title, which has been renamed to `titleId` to emphasis its immutability. +Reloading kprefs are always done through the original `titleId`, +regardless of the actual resource currently used. \ No newline at end of file -- cgit v1.2.3