| commit | b48f6d22cbb29072263dccc960f4c7a673440b73 | [log] [tgz] |
|---|---|---|
| author | Nick Ning <nickning@google.com> | Thu Aug 18 20:06:35 2022 +0000 |
| committer | Nick Ning <nickning@google.com> | Mon Aug 22 20:45:23 2022 +0000 |
| tree | 63e57ab746a9849e36010e7de9f981154bd02186 | |
| parent | fa471362fd27c705b38ff65f674ac93f648ff2c5 [diff] |
Gallery Template 6: Added more documentation for API changes. Addressed API review questions: 1. Is priority used when there’s not enough space to fit everything? Or for ordering? Priority is a number assigned to blocks to show the semantic importance of each block in a sequence. Different templates will interpret priority in different ways. Some may treat this as an ordering, some may only use it to define which elements are most important when showing smaller layouts. 2. What happens if two entities have equal priority and only one of them fits? If two blocks has the same priority number, the default order (e.g. text before image) is used. 3. Does a larger priority value mean higher priority? Why is 0 the highest? Priority number is zero based with smaller numbers being higher priority. 4. Why do not all blocks have a priority? This is the current scope by design. We may include it in more block types should ordering be a designed feature. 5. AspectRatio: What about images that don’t fit those ratios, should this be customizable? Images not in the selected ratio are cropped for display by design. Added more doc in CL. UX design might introduce more customization features on this later. 6. ImageSize: Can you provide more context as to what the “relative” means in the javadoc? Relative to what? The image size describes image scale category in sizing. Actual size is implementation dependent. Removed the confusing notion of "relative". Added more doc in CL. 7. TextBlock: Why 3 text items? Could this take a List<TemplateText> instead? Current limit of 3 text items is intentional by design to avoid unintentional clogging limited screen space, forcing users to pick three most important types of information to display. 8. TextBlock: Should we prevent text3 from being non-null if text2 is? Or is that an ok situation? It is an ok situation that the code can handle to display only the non-null items. Bug: 242826378 Bug: 214598261 Test: Integration Test Demo Relnote: Add proiority number range for TextBlock and ImageBlock. Change-Id: I73100492fedc879ea75b507b9fe302079baa4ef6
Jetpack is a suite of libraries, tools, and guidance to help developers write high-quality apps easier. These components help you follow best practices, free you from writing boilerplate code, and simplify complex tasks, so you can focus on the code you care about.
Jetpack comprises the androidx.* package libraries, unbundled from the platform APIs. This means that it offers backward compatibility and is updated more frequently than the Android platform, making sure you always have access to the latest and greatest versions of the Jetpack components.
Our official AARs and JARs binaries are distributed through Google Maven.
You can learn more about using it from Android Jetpack landing page.
For contributions via GitHub, see the GitHub Contribution Guide.
Note: The contributions workflow via GitHub is currently experimental - only contributions to the following projects are being accepted at this time:
When contributing to Jetpack, follow the code review etiquette.
We are not currently accepting new modules.
Head over to the onboarding docs to learn more about getting set up and the development workflow!
Our continuous integration system builds all in progress (and potentially unstable) libraries as new changes are merged. You can manually download these AARs and JARs for your experimentation.
Before uploading your first contribution, you will need setup a password and agree to the contribution agreement:
Generate a HTTPS password: https://android-review.googlesource.com/new-password
Agree to the Google Contributor Licenses Agreement: https://android-review.googlesource.com/settings/new-agreement
AndroidX uses git to store all the binary Gradle dependencies. They are stored in prebuilts/androidx/internal and prebuilts/androidx/external directories in your checkout. All the dependencies in these directories are also available from google(), jcenter(), or mavenCentral(). We store copies of these dependencies to have hermetic builds. You can pull in a new dependency using our importMaven tool.
