UI

Упрощает макет, убирая лишний уровень вложенности. Дочерние элементы <merge> добавляются напрямую в родительский макет, без создания дополнительного контейнера. Это улучшает производительность и упрощает структуру.

<!-- layout/fragment_example.xml -->
<merge xmlns:android="http://schemas.android.com/apk/res/android">
    <TextView
        android:id="@+id/example_text_view"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World" />

    <Button
        android:id="@+id/example_button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Click Me" />
</merge>

Используется для повторного использования макетов и упрощения их структуры. Он позволяет включать один макет в другой, что помогает избежать дублирования кода и улучшает читаемость и поддерживаемость вашего проекта.

<!-- layout/activity_main.xml -->
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <include
        layout="@layout/fragment_example" />

</LinearLayout>

Позволяет накладывать несколько изображений друг на друга в виде слоев. Каждый слой можно настроить по размеру, положению и порядку наложения.

• Слои отображаются в порядке их перечисления: первым идет самый нижний слой, последним — самый верхний.

• Если у слоя не указаны размеры, он займет весь доступный контейнер.

<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <item
        android:id="@+id/background"
        android:drawable="@color/background_color"
        android:padding="8dp" />

    <item
        android:drawable="@drawable/icon_shadow"
        android:left="5dp"
        android:top="5dp"
        android:right="5dp"
        android:bottom="5dp"
        android:opacity="opaque" />

    <item
        android:drawable="@drawable/icon_main"
        android:width="48dp"
        android:height="48dp"
        android:gravity="center"
        android:visible="true" />

    <item
        android:drawable="@drawable/icon_overlay"
        android:paddingLeft="4dp"
        android:paddingTop="4dp"
        android:paddingRight="4dp"
        android:paddingBottom="4dp"
        android:blendMode="src_over" />
</layer-list>

imageView.setImageResource(R.drawable.layered_icon)

• drawable указывает изображение или цвет для слоя.

• id задает уникальный идентификатор слоя.

• left отступ от левой стороны контейнера.

• top отступ от верхней стороны контейнера.

• right отступ от правой стороны контейнера.

• bottom отступ от нижней стороны контейнера.

• width задает ширину слоя (в dp).

• height задает высоту слоя (в dp).

• gravity указывает позиционирование слоя (например, center, left, right).

• padding задает общий отступ внутри слоя.

• paddingLeft отступ внутри слоя от левой стороны.

• paddingTop отступ внутри слоя от верхней стороны.

• paddingRight отступ внутри слоя от правой стороны.

• paddingBottom отступ внутри слоя от нижней стороны.

• opacity задает прозрачность слоя (opaque, translucent, transparent).

• visible определяет, отображается ли слой (true или false).

• blendMode указывает режим смешивания слоя (src_over, multiply, screen и другие).

Позволяет отображать разные изображения в зависимости от состояния View. Порядок элементов важен: первым должен быть <item> с более специфичным состоянием.

<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:drawable="@drawable/item_pressed" android:state_pressed="true" />
    <item android:drawable="@drawable/item_enabled" android:state_enabled="true" />
    <item android:drawable="@drawable/item_disabled" android:state_enabled="false" />
    <item android:drawable="@drawable/item_checked" android:state_checked="true" />
    <item android:drawable="@drawable/item_selected" android:state_selected="true" />
    <item android:drawable="@drawable/item_focused" android:state_focused="true" />
    <item android:drawable="@drawable/item_activated" android:state_activated="true" />
    <item android:drawable="@drawable/item_drag_can_accept" android:state_drag_can_accept="true" />
    <item android:drawable="@drawable/item_drag_hovered" android:state_drag_hovered="true" />
    <item android:drawable="@drawable/item_hovered" android:state_hovered="true" />
    <item android:drawable="@drawable/item_window_focused" android:state_window_focused="true" />
    <item android:drawable="@drawable/item_checkable" android:state_checkable="true" />
    <item android:drawable="@drawable/item_multiline" android:state_multiline="true" />
    <item android:drawable="@drawable/item_first" android:state_first="true" />
    <item android:drawable="@drawable/item_last" android:state_last="true" />
    <item android:drawable="@drawable/item_middle" android:state_middle="true" />
</selector>

imageView.setImageResource(R.drawable.button_state_list)

• state_pressed состояние нажатия.

• state_enabled элемент включен или отключен.

• state_checked находится в состоянии выбора (например, для CheckBox).

• state_selected выделена пользователем.

• state_focused находится в фокусе.

• state_activated активирована (например, для ListView).

• state_active обозначение активного элемента.

• state_drag_can_accept может принять перетаскиваемый объект.

• state_drag_hovered находится под перетаскиваемым объектом.

• state_hovered указатель (например, мышь) находится над элементом.

• state_window_focused окно, в котором находится элемент, в фокусе.

• state_checked_highlighted выбор элемента с дополнительной визуальной подсветкой.

• state_checkable поддерживает состояние выбора.

• state_multiline поддерживает многострочный текст.

• state_first первый элемент в группе.

• state_last последний элемент в группе.

• state_middle находится между первым и последним в группе.

Отображает разные изображения в зависимости от текущего уровня.

<level-list xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:drawable="@drawable/battery_empty" android:minLevel="0" android:maxLevel="20" />
    <item android:drawable="@drawable/battery_low" android:minLevel="21" android:maxLevel="50" />
    <item android:drawable="@drawable/battery_half" android:minLevel="51" android:maxLevel="80" />
    <item android:drawable="@drawable/battery_full" android:minLevel="81" android:maxLevel="100" />
</level-list>

imageView.setImageResource(R.drawable.battery_level_list)
imageView.drawable.level = 45

• minLevel минимальный уровень, при котором изображение отображается.

• maxLevel максимальный уровень, при котором изображение отображается.

Определяет формат и качество хранения пиксельных данных в Bitmap. Выбор конфигурации влияет на количество памяти, занимаемой изображением, а также на поддерживаемые цветовые каналы и прозрачность.

• ALPHA_8 изображение с 8-битным альфа-каналом (прозрачность).

• RGB_565 изображение с 16-битными пикселями (5 бит красный, 6 бит зеленый, 5 бит синий). Меньше памяти, но без альфа-канала.

• ARGB_8888 изображение с 32-битными пикселями (по 8 бит на каждый канал: альфа, красный, зеленый, синий). Высокое качество, но больше занимает памяти.

• RGBA_F16 изображение с 16-битными значениями для каждого канала. Используется для изображений высокого качества.

• HARDWARE используется аппаратное ускорение для обработки изображения. Значительно повышает производительность, но не поддерживает прямое изменение пикселей через методы getPixel() и setPixel().

• RGBA_1010102 изображение с 10-битными значениями для каналов красного, зеленого и синего и 2-битным альфа-каналом. Используется для изображений высокого качества на устройствах с HDR-экраном.

Создает новый пустой Bitmap с заданной шириной, высотой и конфигурацией.

val bitmap = Bitmap.createBitmap(200, 200, Bitmap.Config.ARGB_8888)

Создает копию текущего Bitmap с новой конфигурацией. Если isMutable = true, то копия будет изменяемой.

val bitmapCopy = bitmap.copy(Bitmap.Config.RGB_565, true)

Возвращают ширину Bitmap в пикселях.

val width = bitmap.width

Возвращают высоту Bitmap в пикселях.

val height = bitmap.height

Возвращает цвет пикселя по указанным координатам в виде значения Int.

val color = bitmap.getPixel(50, 50)

Устанавливает цвет пикселя по указанным координатам. Работает только для изменяемых Bitmap.

bitmap.setPixel(50, 50, Color.RED)

Сохраняет Bitmap в указанный поток в сжатом виде. Параметр quality определяет степень сжатия (0–100).

bitmap.compress(Bitmap.CompressFormat.PNG, 100, FileOutputStream("output.png"))

Освобождает память, занятую Bitmap. Используется, когда изображение больше не нужно, чтобы избежать утечек памяти.

bitmap.recycle()

Возвращает true, если Bitmap можно изменять, и false, если изображение неизменяемое.

val isMutable = bitmap.isMutable

Заполняет все пиксели Bitmap указанным цветом. Работает только для изменяемых изображений.

bitmap.eraseColor(Color.WHITE)

Возвращает true, если изображение поддерживает альфа-канал (прозрачность).

val supportsAlpha = bitmap.hasAlpha()

Создает новый Bitmap, содержащий только альфа-канал (прозрачность) исходного изображения.

val alphaBitmap = bitmap.extractAlpha()

Используется для декодирования изображений из различных источников, таких как файлы, ресурсы, потоки или байтовые массивы, в объекты Bitmap.

val bitmap = BitmapFactory.decodeResource(resources, R.drawable.sample_image)

val bitmap = BitmapFactory.decodeFile("/storage/emulated/0/Download/image.jpg")

val inputStream = URL("https://example.com/image.png").openStream()
val bitmap = BitmapFactory.decodeStream(inputStream)
inputStream.close()

val bitmap = BitmapFactory.decodeByteArray(byteArray, 0, byteArray.size)

Используется для отображения растровых изображений (Bitmap) в Android. Он позволяет загружать, отображать и настраивать растровые изображения, например, управлять их масштабом или положением.

Позволяет рисовать простые фигуры (прямоугольники, овалы, линии и т. д.).

Позволяет объединить несколько Drawable в один слой. Каждый слой может быть отрисован отдельно, с возможностью управления их положением и прозрачностью.

Позволяет отображать разные изображения (Drawable) в зависимости от состояния элемента интерфейса, например, нажатия, выделения или отключения.

Позволяет создавать растягиваемые изображения для фоновых элементов, кнопок или других UI-компонентов. Использует .9.png файлы, которые имеют встроенные данные для растяжения и заполнения.

Класс в Android для работы с векторными изображениями. Он позволяет описывать графику в виде XML-файлов с использованием форм, линий и цветов.

Позволяет создавать анимации из последовательности изображений (кадров). Он используется для покадровой анимации, где каждое изображение отображается в течение заданного времени.

Density-independent pixels — единица измерения, которая используется для создания интерфейсов, независимых от плотности пикселей экрана. 1 dp эквивалентен 1 пикселю на экране с плотностью 160 dpi. Это помогает поддерживать стабильные размеры элементов интерфейса на устройствах с разной плотностью пикселей.

Scale-independent pixels — единица измерения для текста в Android, которая учитывает настройки размера шрифта пользователя (например, для доступности). Используется для определения размеров текста, чтобы он корректно отображался на разных устройствах и при разных настройках экрана.

Квалификатор, который используется для ресурсов, не зависящих от плотности пикселей экрана. Такие ресурсы будут одинаково отображаться на всех устройствах.

Квалификатор для ресурсов, который используется на устройствах с любым разрешением экрана.

Ресурс, предназначенный для отображения текста с учётом числового значения, чтобы правильно склонять слова.

• Для ru-строк корректно будет работать только если в системе установлен русский язык.

<plurals name="item_count">
    <item quantity="zero">Нет предметов</item>
    <item quantity="one">%d предмет</item>
    <item quantity="two">%d предмета</item>
    <item quantity="few">%d предмета</item>
    <item quantity="many">%d предметов</item>
    <item quantity="other">%d предметов</item>
</plurals>

val count = 3
val text = resources.getQuantityString(R.plurals.item_count, count, count)
textView.text = text

• zero используется для значения 0.

• one используется для чисел 1, 21, 31 и т.д.

• two используется в некоторых языках (например, на арабском) для значения 2.

• few используется для чисел от 2 до 4 в русском языке.

• many используется для чисел от 5 до 20, а также для всех значений, кратных 10.

• other используется по умолчанию, если никакое другое правило не подходит.

Если вы используете LayoutInflater в производительном коде, например, в адаптерах RecyclerView, рекомендуется использовать метод inflate с параметром attachToRoot = false, чтобы избежать лишних операций и улучшить производительность.

val view = LayoutInflater.from(context).inflate(R.layout.my_layout, rootView, attachToRoot = true)

Позволяет асинхронно инфлейтить XML-разметку. Это полезно для улучшения производительности и избегания блокировки основного потока приложения при создании сложных или ресурсозатратных пользовательских интерфейсов. Выполняется в фоновом потоке.

AsyncLayoutInflater(context).inflate(R.layout.my_layout, null) { inflatedView, _, _ ->
    // Этот блок кода выполняется после завершения инфлейтации
    // Вы можете использовать inflatedView для дальнейших операций
}

Позволяет добавить FrameCallback, который будет вызван перед следующим обновлением экрана. Это полезно для выполнения задач, которые должны быть синхронизированы с кадровой частотой, например, обновление анимаций.

Choreographer.getInstance().postFrameCallback(object: Choreographer.FrameCallback {
    override fun doFrame(frameTimeNanos: Long) {
        // Ваш код для обновления UI
        Choreographer.getInstance().postFrameCallback(this) // Повторное добавление
    }
})

Позволяет добавить Runnable (или Callback) для выполнения задачи в заданный момент времени, например, после обновления экрана.

Choreographer.getInstance().postCallback(
    Choreographer.CALLBACK_ANIMATION,
    Runnable {
        // Ваш код для выполнения после обновления экрана
    },
    null
)

Специальная тема, предоставляемая библиотекой SplashScreen Compat в Android, предназначенная для настройки внешнего вида сплэш-экрана вашего приложения. Она позволяет определять, как будет выглядеть сплэш-экран при запуске приложения.

<style name="Theme.App.Starting" parent="Theme.SplashScreen">
    <item name="windowSplashScreenBackground">@color/splash_background</item>
    <item name="windowSplashScreenAnimatedIcon">@drawable/ic_animated_icon</item>
    <item name="windowSplashScreenIconBackgroundColor">@color/icon_background</item>
    <item name="windowSplashScreenAnimationDuration">500</item>
    <item name="android:windowSplashScreenBrandingImage">@drawable/ic_branding_image</item>
    <item name="postSplashScreenTheme">@style/Theme.App</item>
</style>

Задает цвет фона сплэш-экрана.

<item name="windowSplashScreenBackground">@color/splash_background</item>

Определяет иконку, отображаемую на сплэш-экране.

<item name="windowSplashScreenAnimatedIcon">@drawable/ic_animated_icon</item>

Устанавливает цвет фона для иконки.

<item name="windowSplashScreenIconBackgroundColor">@color/icon_background</item>

Задает продолжительность анимации сплэш-экрана в миллисекундах.

<item name="windowSplashScreenAnimationDuration">500</item>

Добавляет брендированное изображение.

<item name="android:windowSplashScreenBrandingImage">@drawable/ic_branding_image</item>

Определяет тему, которая будет применяться после показа сплэш-экрана.

<item name="postSplashScreenTheme">@style/Theme.App</item>

Используется для установки и настройки SplashScreen в Activity, обеспечивая возможность кастомизации его поведения и внешнего вида.

class MainActivity: ComponentActivity() {
    
    override fun onCreate(savedInstanceState: Bundle?) {
        // Устанавливаем экран загрузки
        val splashScreen = installSplashScreen()
        super.onCreate(savedInstanceState)
    }
}

Позволяет управлять тем, как долго экран загрузки будет оставаться видимым, в зависимости от определенного условия.

class MainActivity: ComponentActivity() {
    
    override fun onCreate(savedInstanceState: Bundle?) {
        val splashScreen = installSplashScreen()
        splashScreen.setKeepOnScreenCondition { viewModel.splashLoading.value }
        super.onCreate(savedInstanceState)
    }
}

class MainViewModel: ViewModel() {
	  private val _splashLoading = MutableStateFlow(true)
    val splashLoading: StateFlow<Boolean> get() = _splashLoading.asStateFlow()
}

Класс, который используется для распознавания простых жестов пользователя, таких как нажатие, двойное нажатие, смахивание и прокрутка. Этот класс помогает обработать сложные взаимодействия с пользователем на основе последовательности событий касания.

val gestureDetector = GestureDetector(context, object: GestureDetector.SimpleOnGestureListener() {
    override fun onSingleTapUp(e: MotionEvent): Boolean {
        // обработка одиночного нажатия
        return true
    }

    override fun onLongPress(e: MotionEvent) {
        // обработка долгого нажатия
    }

    override fun onFling(e1: MotionEvent, e2: MotionEvent, velocityX: Float, velocityY: Float): Boolean {
        // обработка смахивания
        return true
    }
})

override fun onTouchEvent(event: MotionEvent): Boolean {
    return gestureDetector.onTouchEvent(event)
}

Интерфейс, который используется для обработки жестов пользователя.

Представляет механизм для запуска анимаций вычисления анимированных значений и установки их для целевых объектов.

Наследуется от ValueAnimator. Обеспечивает поддержку анимации свойств целевых объектов. Анимации можно создавать из кода и XML.

Вызывается через View.animate. Подходит для выполнения нескольких анимаций одновременно.