涂鸦

  
激发开发出卓越的触控笔应用的灵感。降低开发者进入高性能、美观的手写体验的门槛。
最近更新时间 稳定版 候选版 Beta 版 Alpha 版
2025 年 6 月 18 日 - - - 1.0.0-alpha05

声明依赖项

如需添加 Ink 的依赖项，您必须将 Google Maven 制品库添加到项目中。如需了解详情，请参阅 Google 的 Maven 代码库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

Groovy

dependencies {
  
    implementation "androidx.ink:ink-authoring:1.0.0-alpha05"
    implementation "androidx.ink:ink-brush:1.0.0-alpha05"
    implementation "androidx.ink:ink-geometry:1.0.0-alpha05"
    implementation "androidx.ink:ink-nativeloader:1.0.0-alpha05"
    implementation "androidx.ink:ink-rendering:1.0.0-alpha05"
    implementation "androidx.ink:ink-strokes:1.0.0-alpha05"
    
}

Kotlin

dependencies {


    implementation("androidx.ink:ink-authoring:1.0.0-alpha05")
    implementation("androidx.ink:ink-brush:1.0.0-alpha05")
    implementation("androidx.ink:ink-geometry:1.0.0-alpha05")
    implementation("androidx.ink:ink-nativeloader:1.0.0-alpha05")
    implementation("androidx.ink:ink-rendering:1.0.0-alpha05")
    implementation("androidx.ink:ink-strokes:1.0.0-alpha05")
}

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

此工件没有版本说明。

版本 1.0

版本 1.0.0-alpha05

2025 年 6 月 18 日

发布了 androidx.ink:ink-*:1.0.0-alpha05。版本 1.0.0-alpha05 包含这些提交内容。

新功能

  • 为创作、画笔和几何图形模块组合 Compose 互操作性模块

API 变更

  • 新增了 Compose Interoperability 模块和 API，进行了 API 清理 (I0e464)
  • 移除了返回 kotlin.Result 的 InProgressStroke.enqueueInputs/updateShape 方法，客户端应改用 enqueueInputsOrThrow 或 enqueueInputsOrIgnore 等。将 InProgressStroke.getNeedsUpdate 重命名为 isUpdateNeeded。InProgressStroke.populateOutlinePosition 现在会返回其输出参数，以允许调用链接，与 Ink 中的其他方法保持一致。TextureBitmapStore 接口已从渲染模块移至画笔模块。BoxAccumulator.populateFrom 应接受可为 null 的不可变 Box，而不是可变的 BoxAccumulator，为了更清楚地了解哪些内容发生了更改，调用方应将 boxAccumulator.add(other) 更改为 boxAccumulator.add(other.box)。BrushUtil.toBuilderWithAndroidColor/createBuilderWithAndroidColor 已被移除，请改为在构建后使用 Brush.Builder 的 setAndroidColor。(Ia7155)
  • 之前的实验性属性 InProgressStrokesView.textureBitmapStore 现已变为私有属性。此属性仍有公共访问器。(I1d706)

bug 修复

  • 改进了包含许多粒子的自定义画笔的性能。

版本 1.0.0-alpha04

2025 年 4 月 9 日

发布了 androidx.ink:ink-*:1.0.0-alpha04。版本 1.0.0-alpha04 包含这些提交内容。

新功能

  • 为自定义 BrushFamily 对象引入了新的实验性 API，支持铅笔和激光笔等新画笔。该 API 允许加载此 proto 定义的画笔。(I8809a)

版本 1.0.0-alpha03

2025 年 2 月 12 日

发布了 androidx.ink:ink-*:1.0.0-alpha03。版本 1.0.0-alpha03 包含这些提交内容。

新功能

  • 缩减磁盘和网络大小：序列化 StrokeInputBatch，可省去许多行代码，生成的对象仅占传统存储笔触大小的一小部分。(Ie898d)
  • 套索选择：虚线笔刷用于绘制选择笔触，以及用于将选择笔触转换为 PartitionedMesh 以进行几何图形查询的函数。(Ia38a0)

版本 1.0.0-alpha02

2024 年 12 月 11 日

发布了 androidx.ink:ink-*:1.0.0-alpha02。版本 1.0.0-alpha02 包含这些提交内容。

API 变更

  • 修复了若干 bug。(I05dd8)

外部贡献

  • 废弃了 BuildCompat.isAtLeastV。调用方应改为直接将 SDK_INT 与 35 进行比较。(I294d1)

版本 1.0.0-alpha01

2024 年 10 月 2 日

发布了 androidx.ink:ink-*:1.0.0-alpha01。版本 1.0.0-alpha01 包含这些提交内容。

新功能

  • 这是一个模块化且可配置的库，可让您轻松创建、渲染和操控在应用中创作的精美墨迹笔画。

API 变更

新模块可帮助开发者打造丰富的手写体验：

  • 创作：使用 InProgressStrokesView 在收到输入时实时高性能、低延迟地渲染笔触。
  • 渲染：使用 CanvasStrokeRenderer 和 ViewStrokeRenderer 在应用界面中绘制完成的墨迹。
  • 笔触：用于手写特征的核心数据类型。
  • 画笔：可配置的规范，用于指定笔触在响应用户输入时的外观和行为。
  • 几何图形：几何图形操作（例如交集和覆盖）可为选择和擦除等强大工具提供支持。