墨水
| 最近更新时间 | 稳定版 | 候选版 | Beta 版 | Alpha 版 |
|---|---|---|---|---|
| 2026 年 11 月 18 日 | 1.0.0 | - | - | 1.1.0-alpha12 |
声明依赖项
如需添加 Ink 的依赖项,您必须将 Google Maven 仓库添加到项目中。如需了解详情,请参阅 Google 的 Maven 代码库。
在应用或模块的 build.gradle 文件中添加所需工件的依赖项:
Groovy
dependencies { implementation "androidx.ink:ink-authoring:1.1.0-alpha12" implementation "androidx.ink:ink-authoring-compose:1.1.0-alpha12" implementation "androidx.ink:ink-brush:1.1.0-alpha12" implementation "androidx.ink:ink-brush-compose:1.1.0-alpha12" implementation "androidx.ink:ink-geometry:1.1.0-alpha12" implementation "androidx.ink:ink-geometry-compose:1.1.0-alpha12" implementation "androidx.ink:ink-nativeloader:1.1.0-alpha12" implementation "androidx.ink:ink-rendering:1.1.0-alpha12" implementation "androidx.ink:ink-storage:1.1.0-alpha12" implementation "androidx.ink:ink-strokes:1.1.0-alpha12" }
Kotlin
dependencies { implementation("androidx.ink:ink-authoring:1.1.0-alpha12") implementation("androidx.ink:ink-authoring-compose:1.1.0-alpha12") implementation("androidx.ink:ink-brush:1.1.0-alpha12") implementation("androidx.ink:ink-brush-compose:1.1.0-alpha12") implementation("androidx.ink:ink-geometry:1.1.0-alpha12") implementation("androidx.ink:ink-geometry-compose:1.1.0-alpha12") implementation("androidx.ink:ink-nativeloader:1.1.0-alpha12") implementation("androidx.ink:ink-rendering:1.1.0-alpha12") implementation("androidx.ink:ink-storage:1.1.0-alpha12") implementation("androidx.ink:ink-strokes:1.1.0-alpha12") }
如需详细了解依赖项,请参阅添加 build 依赖项。
反馈
您的反馈将帮助我们改进 Jetpack。如果您发现了新问题,或对此库有任何改进建议,请告诉我们。创建新问题前,请先查看此库中的现有问题。您可以点击星标按钮,为现有问题投票。
如需了解详情,请参阅问题跟踪器文档。
Ink 版本 1.1
版本 1.1.0-alpha12
2026 年 11 月 18 日
发布了 androidx.ink:ink-*:1.1.0-alpha12。版本 1.1.0-alpha12 包含这些提交内容。
API 变更
- 为来自特定设备的未完成笔画添加了 Ink
InProgressShapesView方法重载 (I9c945) - 在 Ink 创作模块中同时支持多个输入设备 (I41ee5)
- 添加了 linux-aarch64 JVM 支持 (I752e5, I1216b)
bug 修复
- 将笔画形状时长限制为非负且单调(I752e5、b/552666754)
- 将
CanvasInProgressStrokesRenderHelperV33请求的帧速率更改为 720F。(I752e5) - 更新了
ink-authoring和ink-authoring-compose对input-motionprediction的依赖项 (Ib84ef)
版本 1.1.0-alpha11
2026 年 11 月 4 日
发布了 androidx.ink:ink-*:1.1.0-alpha11。版本 1.1.0-alpha11 包含这些提交内容。
API 变更
- 添加了实验性 Ink API,用于计算/存储具有动画纹理的笔画的相位偏移 (I620e6)
- 添加了实验性 Ink 笔刷 API,用于指定动画绘制纹理 (If0f10)
- 笔画形状 (
PartitionedMesh) 序列化,用于保存部分擦除的笔画,或通过保存网格数据来加快文档加载速度 (I1604f)
bug 修复
- 修复了并发输入处理问题,并改进了枪管扭曲兼容性。(I0fc23)
版本 1.1.0-alpha10
2026 年 10 月 21 日
发布了 androidx.ink:ink-*:1.1.0-alpha10。版本 1.1.0-alpha10 包含这些提交内容。
bug 修复
- 为使用局部笔画橡皮擦编辑的笔画的切边添加抗锯齿效果(
Stroke.subtract,后跟Stroke.split[可选])
版本 1.1.0-alpha09
2026 年 9 月 23 日
发布了 androidx.ink:ink-*:1.1.0-alpha09。版本 1.1.0-alpha09 包含这些提交内容。
API 变更
- 将画笔颜色偏移更改为在 Oklab 色彩空间中运行,这样可以更好地保留色相偏移中的感知亮度。将
SATURATION和LUMINOSITY换档刷目标 API 分别重命名为CHROMA和LIGHTNESS。(I0ed42)
bug 修复
androidx.lifecycle:lifecycle-runtime依赖项已更新至 2.10.0。此版本是必需的,以便捆绑的生命周期运行时 lint 检查能够与 AGP 9.5.0-alpha04 或更高版本一起运行。(I99bfd、b/556807521)
版本 1.1.0-alpha08
2026 年 9 月 9 日
发布了 androidx.ink:ink-*:1.1.0-alpha08。版本 1.1.0-alpha08 包含这些提交内容。
API 变更
- 在选择启用注解
ExperimentalInkCrossPlatformRenderingApi下,通过MetalRenderer为 KMP iOS 添加渲染支持,基于 KMP 通用 API 实现核心功能 - 将
Target.TEXTURE_ANIMATION_PROGRESS_OFFSET重命名为Target.PAINT_ANIMATION_PROGRESS_OFFSET。(I8809f) - 添加了重载
ImmutableAffineTransform.translate(float x, float, y)和MutableAffineTransform populateFromTranslation(float x, float y)(I8809f) - 将
DampingNode属性从dampingSource重命名为dampOver(Id3178) - 将
DampingNode属性从dampingGap重命名为strength(I69432) - 定义
EasingFunction.CubicBezier时,请使用Vec类型,而不是Float(I69432) - 为网格编辑橡皮擦函数
Stroke.subtract和Stroke.split添加了WorkerThread注解 (I69432)
bug 修复
- 使
Brush示例与 KMP 兼容 (I77125)
版本 1.1.0-alpha07
2026 年 8 月 12 日
发布了 androidx.ink:ink-*:1.1.0-alpha07。版本 1.1.0-alpha07 包含这些提交内容。
API 变更
- 修复了影响密集粒子笔刷的性能下降问题,并根据 API 反馈更新了 Brush.Version 常量 (I87f0f)
版本 1.1.0-alpha06
2026 年 7 月 29 日
发布了 androidx.ink:ink-*:1.1.0-alpha06。版本 1.1.0-alpha06 包含这些提交内容。
API 变更
- 向 API 添加了
calculateMinimumRequiredVersion方法,以支持BrushFamily子类型。(I338c9) - 公开
AffineTransform组件字段 (Ic2ec3) - 修复了
InProgressStrokesView中的内存泄漏问题,改进了实验性部分笔画橡皮擦视觉伪影,改进了自定义笔刷纹理层的 protobuf 表示法 (I6ff86) - 为
MutableAffineTransform添加了初始化构造函数(以匹配ImmutableAffineTransform)(I96ec7) - 添加了
InProgressStroke.clear(Ie0032) - 向具有可变和不可变子类的数据结构添加了
toImmutable方法 (I53835) - KMP 迁移(Icbf38、b/521850119、b/534309122)
bug 修复
- 进一步支持笔刷版本控制和纹理动画。(Iea9ba)
版本 1.1.0-alpha05
2026 年 7 月 15 日
发布了 androidx.ink:ink-*:1.1.0-alpha05。版本 1.1.0-alpha05 包含这些提交内容。
API 变更
- 实验性发布了新的橡皮擦类型,称为“部分笔画”“网格编辑”或“像素”橡皮擦,可编辑笔画几何图形并拆分笔画,而不是删除整个笔画或用背景颜色遮盖笔画。已知问题包括:切割边缘缺乏抗锯齿效果,以及没有用于保存擦除
PartitionedMesh结果的序列化 API,这些问题都将在未来版本中得到解决。 - 向
StrokeInputBatchSerialization.decode添加了缺失的 Throws 注解,需要该方法的 Java 使用方进行更新。(I83473、b/522256938)
bug 修复
- 修复了因数值精度问题导致的原生代码崩溃(I2e1f0、6618e69、b/523190724)
- 舍弃
BrushTipExtruder中的退化挤压 (469b629) - 修复了
InProgressStrokesView中的RejectedExecutionException(b/526696762)
版本 1.1.0-alpha04
2026 年 6 月 17 日
发布了 androidx.ink:ink-*:1.1.0-alpha04。版本 1.1.0-alpha04 包含这些提交内容。
API 变更
修复了浮点精度问题,该问题会导致完成的笔画中出现视觉伪影,影响操作系统升级后的某些设备
为存储模块添加了 KMP 通用 API(往返于
ByteArray,而不是 JavaInputStream/OutputStream)。添加
BrushBehavior.developerComment属性,以保存说明自定义笔刷系列设计的元数据。此 API 旨在支持 Brush Designer 界面。修复了
CanvasInProgressStrokesRenderHelperV33中线程一致性检查方面的 bug。修复了处理
MotionEvent可选字段(例如倾斜、压力)时的一些 bug。改进了自定义画笔 API 的文档。
添加了新的
BrushPaint.ColorFunction类型。
版本 1.1.0-alpha03
2026 年 5 月 19 日
发布了 androidx.ink:ink-*:1.1.0-alpha03。版本 1.1.0-alpha03 包含这些提交内容。
API 变更
版本 1.1.0-alpha02
2026 年 4 月 22 日
发布了 androidx.ink:ink-*:1.1.0-alpha02。版本 1.1.0-alpha02 包含这些提交内容。
API 变更
bug 修复
- 修复了在某些设备上使用
InProgressStrokesView.maskPath时出现的闪烁问题 (I1c7bc, b/496920044)
版本 1.1.0-alpha01
2026 年 3 月 11 日
发布了 androidx.ink:ink-*:1.1.0-alpha01。版本 1.1.0-alpha01 包含这些提交内容。
新功能
- 修复了各种小问题
API 变更
- 添加了
InProgressShape.isCanceled,修复了创作模块中的并发问题。(Ibfd32、b/474385518、b/470695777) - 向 Java 公开
CanvasStrokeRenderer.create和InProgressStroke.updateShape的零参数版本 (Id80a1, b/457715938)
bug 修复
- 修复了在 API 29-32 中从窗口分离/重新附加后导致
InProgressStrokesView崩溃的 bug,允许 Vec 操作采用相同的MutableVec作为输入和输出,将 Proguard 配置合并到一个文件中。(Ia4da0) - 将对 graphics-core 的依赖项版本提升至 1.0.4 (Ibfa18)
版本 1.0
版本 1.0.0
2025 年 12 月 17 日
发布了 androidx.ink:ink-*:1.0.0。1.0.0 版包含这些提交内容。
bug 修复
- 将对
graphics-core的依赖项版本提高到 1.0.4 (Ibfa18)
版本 1.0.0-rc01
2025 年 12 月 3 日
发布了 androidx.ink:ink-*:1.0.0-rc01。版本 1.0.0-rc01 包含这些提交内容。
bug 修复
- 更新依赖项版本。(Iecd04)
版本 1.0.0-beta02
2025 年 11 月 19 日
发布了 androidx.ink:ink-*:1.0.0-beta02。版本 1.0.0-beta02 包含这些提交内容。
API 变更
- 实验性自定义低延迟形状 API、各种问题修复 (Ib8d2f)
bug 修复
- 提高了
StrokeInputBatch序列化的浮点精度,修复了重复编码和解码导致的值漂移问题 - 更强大的系统输入清理功能。
- 修复了
InProgressStrokes可组合项中的画笔纹理支持
版本 1.0.0-beta01
October 22, 2025
发布了 androidx.ink:ink-*:1.0.0-beta01。版本 1.0.0-beta01 包含这些提交内容。
bug 修复
- 为 beta01 版本发布做准备而进行的 bug 修复 (I9900e)
- 减少因过多建模输入彼此过于接近而导致的笔画渲染伪影。
- 修复了输入建模中罕见的崩溃问题。
版本 1.0.0-alpha07
2025 年 10 月 8 日
发布了 androidx.ink:ink-*:1.0.0-alpha07。版本 1.0.0-alpha07 包含这些提交内容。
新功能
StockBrusheshighlighter和emojiHighlighter的SelfOverlap参数,用于替换InProgressStrokesViewrendererFactory- 改进了笔画输入平滑处理的实现,可消除设备测量噪声,但比之前的笔画输入平滑处理实现更准确地反映用户输入
- 提高了与其他 Android/Jetpack API 在角度单位(度与弧度)、转换(倾斜与切变)等方面的一致性
API 变更
- 将与角度相关的 API 更改为使用度数,并在名称中包含单位;在角度转换实用程序中明确说明单位,并同时支持度数和弧度;将
StockBrushesAPI 更改为将库存画笔版本作为工厂函数参数,并为荧光笔画笔公开自重叠行为控制;将MutableAffineTransform.populateFromTranslate重命名为populateFromTranslation;移除InProgressStrokesView.setRenderFactory/getRenderFactory。(Id9eab、b/436656418) - 将 shear 重命名为 skew,澄清了一些文档,移除了
CanvasStrokeRenderer.strokeModifiedRegionOutsetPx,添加了InProgressStroke.changesWithTime(Ia5e70, b/436656418)
bug 修复
- 改进了输入建模,使笔画更准确地反映输入。(I93097)
版本 1.0.0-alpha06
2025 年 8 月 13 日
发布了 androidx.ink:ink-*:1.0.0-alpha06。版本 1.0.0-alpha06 包含这些提交内容。
新功能
- 表情符号荧光笔预设画笔:使用您选择的任何表情符号突出显示文档的某些部分,增添趣味并帮助保持井然有序。
- 更多适用于几何模块基本形状的辅助 API
- 提升设备兼容性和性能
API 变更
- 简化了
InProgressStrokesView的 API,完成了几何图形 API、表情符号荧光笔,从MutableParallelogram中移除了工厂函数,改为使用填充方法,支持为随机笔刷行为设置种子。(I38280)
bug 修复
- 修复了性能问题和湿/干颜色一致性问题。(Ifcd1d)
版本 1.0.0-alpha05
2025 年 6 月 18 日
发布了 androidx.ink:ink-*:1.0.0-alpha05。版本 1.0.0-alpha05 包含这些提交内容。
新功能
- 用于创作、笔刷和几何图形模块的 Compose 互操作性模块
API 变更
- 新增了 Compose 互操作性模块和 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 包含这些提交内容。
新功能
- 引入了新的实验性 API,用于自定义
BrushFamily对象,从而支持铅笔和激光笔等新画笔。该 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 变更
- 修复了各种问题。(I05dd8)
外部贡献
- 废弃了
BuildCompat.isAtLeastV。调用方应改为直接根据 35 检查 SDK_INT。(I294d1)
版本 1.0.0-alpha01
2024 年 10 月 2 日
发布了 androidx.ink:ink-*:1.0.0-alpha01。版本 1.0.0-alpha01 包含这些提交内容。
新功能
- 一个模块化且可配置的库,可让您轻松创建、渲染和操控在应用中创作的精美墨迹笔画。
API 变更
新增模块,可帮助开发者打造丰富的手写体验:
- 创作:使用
InProgressStrokesView,在收到输入时实时、高性能、低延迟地呈现笔画。 - 渲染:使用
CanvasStrokeRenderer和ViewStrokeRenderer将完成的墨迹笔画绘制为应用界面的一部分。 - 笔画:用于墨迹书写功能的核心数据类型。
- 笔刷:可配置的规范,用于指定笔画在响应用户输入时的外观和行为。
- 几何:交集和覆盖等几何运算,可为选择和擦除等工具提供支持。