anko README

The project's README from github.com/Kotlin/anko. As one markdown file: README.md.

obsolete JetBrains project Download GitHub license

Anko logo

:warning: Anko is deprecated. Please see this page for more information.

Anko is a Kotlin library which makes Android application development faster and easier. It makes your code clean and easy to read, and lets you forget about rough edges of the Android SDK for Java.

Anko consists of several parts:

Anko Commons

Anko Commons is a "toolbox" for Kotlin Android developer. The library contains a lot of helpers for Android SDK, including, but not limited to:

Anko Layouts (wiki)

Anko Layouts is a DSL for writing dynamic Android layouts. Here is a simple UI written with Anko DSL:

verticalLayout {
    val name = editText()
    button("Say Hello") {
        onClick { toast("Hello, ${name.text}!") }
    }
}

The code above creates a button inside a LinearLayout and attaches an OnClickListener to that button. Moreover, onClick accepts a suspend lambda, so you can write your asynchronous code right inside the listener!

Note that this is the complete layout code. No XML is required!

Anko has a DSL for ConstraintLayout since v0.10.4

Hello world

There is also a plugin for Android Studio that supports previewing Anko DSL layouts.

Anko SQLite (wiki)

Have you ever been tired of parsing SQLite query results using Android cursors? Anko SQLite provides lots of helpers to simplify working with SQLite databases.

For example, here is how you can fetch the list of users with a particular name:

fun getUsers(db: ManagedSQLiteOpenHelper): List<User> = db.use {
    db.select("Users")
            .whereSimple("family_name = ?", "John")
            .doExec()
            .parseList(UserParser)
}

Anko Coroutines (wiki)

Anko Coroutines is based on the kotlinx.coroutines library and provides:

Using Anko

Gradle-based project

Anko has a meta-dependency which plugs in all available features (including Commons, Layouts, SQLite) into your project at once:

dependencies {
    implementation "org.jetbrains.anko:anko:$anko_version"
}

Make sure that you have the $anko_version settled in your gradle file at the project level:

ext.anko_version='0.10.8'

If you only need some of the features, you can reference any of Anko's parts:

dependencies {
    // Anko Commons
    implementation "org.jetbrains.anko:anko-commons:$anko_version"

    // Anko Layouts
    implementation "org.jetbrains.anko:anko-sdk25:$anko_version" // sdk15, sdk19, sdk21, sdk23 are also available
    implementation "org.jetbrains.anko:anko-appcompat-v7:$anko_version"

    // Coroutine listeners for Anko Layouts
    implementation "org.jetbrains.anko:anko-sdk25-coroutines:$anko_version"
    implementation "org.jetbrains.anko:anko-appcompat-v7-coroutines:$anko_version"

    // Anko SQLite
    implementation "org.jetbrains.anko:anko-sqlite:$anko_version"
}

There are also a number of artifacts for the Android support libraries:

dependencies {
    // Appcompat-v7 (only Anko Commons)
    implementation "org.jetbrains.anko:anko-appcompat-v7-commons:$anko_version"

    // Appcompat-v7 (Anko Layouts)
    implementation "org.jetbrains.anko:anko-appcompat-v7:$anko_version"
    implementation "org.jetbrains.anko:anko-coroutines:$anko_version"

    // CardView-v7
    implementation "org.jetbrains.anko:anko-cardview-v7:$anko_version"

    // Design
    implementation "org.jetbrains.anko:anko-design:$anko_version"
    implementation "org.jetbrains.anko:anko-design-coroutines:$anko_version"

    // GridLayout-v7
    implementation "org.jetbrains.anko:anko-gridlayout-v7:$anko_version"

    // Percent
    implementation "org.jetbrains.anko:anko-percent:$anko_version"

    // RecyclerView-v7
    implementation "org.jetbrains.anko:anko-recyclerview-v7:$anko_version"
    implementation "org.jetbrains.anko:anko-recyclerview-v7-coroutines:$anko_version"

    // Support-v4 (only Anko Commons)
    implementation "org.jetbrains.anko:anko-support-v4-commons:$anko_version"

    // Support-v4 (Anko Layouts)
    implementation "org.jetbrains.anko:anko-support-v4:$anko_version"

    // ConstraintLayout
    implementation "org.jetbrains.anko:anko-constraint-layout:$anko_version"
}

There is an example project showing how to include Anko library into your Android Gradle project.

IntelliJ IDEA project

If your project is not based on Gradle, just attach the required JARs from the jcenter repository as the library dependencies and that's it.

Contributing

The best way to submit a patch is to send us a pull request. Before submitting the pull request, make sure all existing tests are passing, and add the new test if it is required.

If you want to add new functionality, please file a new proposal issue first to make sure that it is not in progress already. If you have any questions, feel free to create a question issue.

Instructions for building Anko are available in the Wiki.

anko (Kotlin/anko)

Searching Database…

15.8K ·GitHub
Anko
archived
Что это такое?Anko — это библиотека для Kotlin, которая ускоряет и упрощает разработку Android-приложений: код остаётся чистым и читаемым, а острые углы Android SDK, рассчитанного на Java, прячутся от вас.
Это одна большая библиотека или набор модулей?Набор из четырёх: Anko Commons (помощники для intents, диалогов, логирования и многого другого), Anko Layouts (DSL для динамических layout'ов), Anko SQLite (DSL для запросов и набор парсеров) и Anko Coroutines (надстройки над kotlinx.coroutines).
Как добавить Anko в своё Android-приложение?В Gradle-проекте добавьте метазависимость — она подключает все части (Commons, Layouts, SQLite) сразу, — или подключите только те части, которые нужны. В IntelliJ-проектах без Gradle JAR-файлы из jcenter подключаются как библиотечные зависимости.
Нужно ли что-то ещё, кроме обычного Android-проекта?Только настроенный Kotlin под Android: Anko написан на Kotlin, а модуль корутин опирается на библиотеку kotlinx.coroutines, которая подтягивается как обычная зависимость.
Стоит ли брать Anko для нового проекта?Не стоит — Anko объявлен устаревшим, а репозиторий заархивирован, поэтому библиотека лучше подходит для сопровождения существующих приложений, чем для новой разработки. В README есть ссылка на страницу с подробностями.
Можно ли описывать layout'ы на Kotlin вместо XML?Да — Anko Layouts — это типобезопасный DSL для динамических Android-layout'ов, и в README подчёркивается, что фрагмент DSL-кода и есть весь код layout'а: XML не нужен. Начиная с v0.10.4, есть DSL и для ConstraintLayout.
Можно ли видеть Anko-layout'ы визуально во время написания кода?Да — есть отдельный плагин для Android Studio, который поддерживает предпросмотр layout'ов, написанных на Anko DSL.
Что Anko даёт для работы с SQLite?Anko SQLite предоставляет DSL для запросов, парсеры и помощники, которые избавляют от ручного разбора курсоров — получить список пользователей с определённым именем можно парой строк.
Как там обстоят дела с фоновым и асинхронным кодом?Слушатели вроде onClick принимают suspend-лямбду, так что асинхронный код можно писать прямо внутри них. Anko Coroutines также добавляет bg() для запуска кода в общем пуле и asReference(), чтобы неканселируемые корутины не удерживали захваченные объекты и не вызывали утечки.
What are similar projects?butterknife, MaterialDrawer, flexbox-layout, vlayout, ImmersionBar, ViewPagerIndicator, ktor, EventBus
Which topics is it in?kotlin-coroutines, kotlin-android, dsl, asynchronous, layout, android-development, android-library, kotlin, sqlite, deprecated, database, mobile
Creator
Kotlin
Size
14.9 MB
Stars
15.8K
Updated
CommitDec 05Releasev0.10.8Nov 09
Age
12y
Commits · 90 Days