README.md
1 Android BasicTransition Sample
2 ===================================
3
4 A basic app showing how to use the Transition framework introduced in
5 KitKat. The app shows radioboxes to select between different Scenes,
6 and uses various ways to transition between them.
7
8 Introduction
9 ------------
10
11 A Scene is an encapsulation of the state of a view hierarchy,
12 including the views in that hierarchy and the various values
13 (layout-related and otherwise) that those views have. A scene can be
14 defined by a layout hierarchy directly or by code which sets up the
15 scene dynamically as it is entered.
16
17 A Transition is a mechanism to automatically animate changes that
18 occur when a new scene is entered. Some transition capabilities are
19 automatic. That is, entering a scene may cause animations to run which
20 fade out views that go away, changeBounds and resize existing views
21 that change, and fade in views that become visible. There are
22 additional transitions that can animate other attributes, such as
23 color changes, and which can optionally be specified to take place
24 during particular scene changes. Finally, developers can define their
25 own Transition subclasses which monitor particular property changes
26 and which run custom animations when those properties change values.
27
28 TransitionManager is used to specify custom transitions for particular
29 scene changes, and to cause scene changes with specific transitions to
30 take place.
31
32 Pre-requisites
33 --------------
34
35 - Android SDK v21
36 - Android Build Tools v21.1.1
37 - Android Support Repository
38
39 Screenshots
40 -------------
41
42 <img src="screenshots/main.png" height="400" alt="Screenshot"/>
43
44 Getting Started
45 ---------------
46
47 This sample uses the Gradle build system. To build this project, use the
48 "gradlew build" command or use "Import Project" in Android Studio.
49
50 Support
51 -------
52
53 - Google+ Community: https://plus.google.com/communities/105153134372062985968
54 - Stack Overflow: http://stackoverflow.com/questions/tagged/android
55
56 If you've found an error in this sample, please file an issue:
57 https://github.com/googlesamples/android-BasicTransition
58
59 Patches are encouraged, and may be submitted by forking this project and
60 submitting a pull request through GitHub. Please see CONTRIBUTING.md for more details.
61
62 License
63 -------
64
65 Copyright 2014 The Android Open Source Project, Inc.
66
67 Licensed to the Apache Software Foundation (ASF) under one or more contributor
68 license agreements. See the NOTICE file distributed with this work for
69 additional information regarding copyright ownership. The ASF licenses this
70 file to you under the Apache License, Version 2.0 (the "License"); you may not
71 use this file except in compliance with the License. You may obtain a copy of
72 the License at
73
74 http://www.apache.org/licenses/LICENSE-2.0
75
76 Unless required by applicable law or agreed to in writing, software
77 distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
78 WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
79 License for the specific language governing permissions and limitations under
80 the License.
81