android/android-ktx

Name: android-ktx

Owner: Android

Description: A set of Kotlin extensions for Android app development.

Created: 2017-11-28 19:37:32.0

Updated: 2018-05-24 18:08:25.0

Pushed: 2018-05-24 19:50:32.0

Homepage: https://android.github.io/android-ktx/core-ktx/

Size: 6225

Language: Kotlin

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Android KTX

A set of Kotlin extensions for Android app development. The goal of Android KTX is to make Android development with Kotlin more concise, pleasant, and idiomatic by leveraging the features of the language such as extension functions/properties, lambdas, named parameters, and parameter defaults. It is an explicit goal of this project to not add any new features to the existing Android APIs.

Kotlin:

uri = Uri.parse(myUriString)

Kotlin with Android KTX:

uri = myUriString.toUri()

Kotlin:

edPreferences.edit()
.putBoolean("key", value)
.apply()

Kotlin with Android KTX:

edPreferences.edit {
putBoolean("key", value)

Kotlin:

pathDifference = Path(myPath1).apply {
op(myPath2, Path.Op.DIFFERENCE)


as.apply {
l checkpoint = save()
anslate(0F, 100F)
awPath(pathDifference, myPaint)
storeToCount(checkpoint)

Kotlin with Android KTX:

pathDifference = myPath1 - myPath2

as.withTranslation(y = 100F) {
drawPath(pathDifference, myPaint)

Kotlin:

.viewTreeObserver.addOnPreDrawListener(
object : ViewTreeObserver.OnPreDrawListener {
    override fun onPreDraw(): Boolean {
        viewTreeObserver.removeOnPreDrawListener(this)
        actionToBeTriggered()
        return true
    }
})

Kotlin with Android KTX:

.doOnPreDraw {
 actionToBeTriggered()
Getting Started

To add Android KTX to your project, add the following to your app module's build.gradle:

sitories {
google()


ndencies {
implementation 'androidx.core:core-ktx:1.0.0-alpha1'

Then, in your Kotlin files where you'd like to use the extensions, import the appropriate packages.

Project Status

This project is currently in preview, and we are seeking feedback from the community. We encourage you to try Android KTX so you can suggest ideas and report issues. Please see the “How to Contribute” section if you would like to contribute.

During the preview period, the Android KTX APIs may change at anytime. When the project reaches a stable state, we will update it to version 1.0 (or later). From that point forward, we will be much more rigorous and careful about maintaining API compatibility.

This project does not currently cover the Android Support Library or Architecture Components APIs.

Links
How to Contribute

We welcome your contributions to this project. There are various ways to contribute:

Reporting issues

Help improve the project by reporting issues that you find by filing a new issue at the Android KTX issue tracker.

Features suggestions

You can also add feature suggestions by filing a new issue at the Android KTX issue tracker.

Documentation

You can help by adding or improving existing documentation. Simply send us a pull request for us to consider your proposed changes.

Bug fixes

Pull requests are welcome for minor bug fixes that do not involve any changes to existing API. These changes should ideally be accompanied by a test case that would have otherwise failed without the fix.

New API or API changes

Pull requests for new APIs or changes to existing APIs are welcome, but may require a bit of discussion. Consider creating an issue to discuss any changes before you implement the change.

Before submitting,

Note: First-time contributors to a Google or Android project will be required to sign a CLA.

License

Copyright 2018 The Android Open Source Project

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.