Landscapist 开源项目教程

Landscapist 开源项目教程

landscapist🌻 A pluggable, highly optimized Jetpack Compose image loading library that fetches and displays network images with Glide, Coil, and Fresco.项目地址:https://gitcode.com/gh_mirrors/la/landscapist

项目介绍

Landscapist 是一个高度优化的插件式 Jetpack Compose 和 Kotlin Multiplatform 图像加载解决方案，支持通过 Glide、Coil 和 Fresco 加载网络图像。该库支持跟踪图像加载状态、组合自定义实现以及一些有价值的动画，如交叉淡入、模糊变换和圆形揭示。您还可以通过图像插件轻松快速地配置和附加图像加载行为。

项目快速启动

添加依赖

首先，在您的项目中添加 Landscapist 的 BOM（Bill of Materials）：

// 导入 landscapist BOM
implementation("com.github.skydoves:landscapist-bom:$version")

// 导入 landscapist 库
implementation("com.github.skydoves:landscapist-glide")
// 或者 fresco 或 coil
implementation("com.github.skydoves:landscapist-placeholder")
implementation("com.github.skydoves:landscapist-palette")
implementation("com.github.skydoves:landscapist-transformation")

使用 GlideImage

在您的 Compose 函数中使用 GlideImage 加载图像：

import androidx.compose.runtime.Composable
import com.skydoves.landscapist.glide.GlideImage

@Composable
fun MyImage() {
    GlideImage(
        imageModel = "https://example.com/image.jpg",
        modifier = Modifier.fillMaxSize(),
        previewPlaceholder = R.drawable.placeholder
    )
}

应用案例和最佳实践

使用 Palette 获取图像调色板

您可以使用 Palette 获取图像的调色板信息：

GlideImage(
    imageModel = "https://example.com/image.jpg",
    modifier = Modifier.fillMaxSize(),
    previewPlaceholder = R.drawable.placeholder,
    paletteLoadedListener = { palette ->
        // 使用调色板信息
    }
)

使用 Paparazzi 进行快照测试

使用 Paparazzi 对 Composable 函数进行快照测试：

import app.cash.paparazzi.Paparazzi

fun testSnapshot() {
    Paparazzi().snapshot {
        CompositionLocalProvider(LocalInspectionMode provides true) {
            GlideImage(
                modifier = Modifier.fillMaxSize(),
                imageModel = "https://example.com/image.jpg",
                previewPlaceholder = painterResource(R.drawable.placeholder)
            )
        }
    }
}

典型生态项目

Accompanist

Landscapist 的灵感主要来自 Accompanist，这是一个包含一些实用工具的库，这些工具在 Jetpack Compose 项目中非常有用。Accompanist 目前包含图像加载和插件等功能。

Paparazzi

Paparazzi 是一个用于对 Composable 函数进行快照测试的工具，可以帮助您在不运行物理设备的情况下获取 Composable 函数的快照图像。

通过这些工具和库，您可以更高效地开发和测试基于 Jetpack Compose 的应用程序。

landscapist🌻 A pluggable, highly optimized Jetpack Compose image loading library that fetches and displays network images with Glide, Coil, and Fresco.项目地址:https://gitcode.com/gh_mirrors/la/landscapist