墨水
| 最近更新時間 | 穩定版 | 候選版 | 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") }
如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。
意見回饋
您的意見可協助我們改善 Jetpack。如果您發現新問題,或是有改進這個程式庫的建議,請告訴我們。回報新問題前,請先查看這個程式庫的現有問題。只要按一下星號按鈕,即可投票給現有的問題。
詳情請參閱 Issue Tracker 說明文件。
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)
修正錯誤
- 將筆劃形狀持續時間限制為非負值和單調 (I752e5、b/552666754)
- 將
CanvasInProgressStrokesRenderHelperV33要求的影格率變更為 720F。(I752e5) - 更新
input-motionprediction的ink-authoring和ink-authoring-compose依附元件 (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)
修正錯誤
- 修正並行輸入內容的處理方式,並提升筆身旋轉相容性。(I0fc23)
1.1.0-alpha10 版
2026 年 10 月 21 日
發布 androidx.ink:ink-*:1.1.0-alpha10。1.1.0-alpha10 版包含這些修訂項目。
修正錯誤
- 為使用部分筆劃橡皮擦編輯的筆劃邊緣加上反鋸齒效果 (
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)
修正錯誤
androidx.lifecycle:lifecycle-runtime依附元件已更新至 2.10.0。如要使用 AGP 9.5.0-alpha04 以上版本執行套裝生命週期執行階段 Lint 檢查,則必須使用這個版本。(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)
修正錯誤
- 讓
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)
修正錯誤
- 進一步支援筆刷版本管理和紋理動畫。(Iea9ba)
1.1.0-alpha05 版本
2026 年 7 月 15 日
發布 androidx.ink:ink-*:1.1.0-alpha05。1.1.0-alpha05 版包含這些修訂項目。
API 變更
- 實驗性推出新的橡皮擦類型,稱為「部分筆劃」、「網格編輯」或「像素」橡皮擦,可編輯筆劃幾何圖形和分割筆劃,而非刪除整個筆劃或用背景顏色遮蓋。已知問題包括剪裁邊緣未消除鋸齒,以及沒有序列化 API 可儲存清除的
PartitionedMesh結果,這些問題都會在日後版本中解決。 - 為
StrokeInputBatchSerialization.decode新增缺少的 Throws 註解,該方法的 Java 使用者必須更新。(I83473、b/522256938)
修正錯誤
- 修正因數值精確度問題導致的原生程式碼發生錯誤 (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 變更
修正浮點精確度問題,避免在完成筆劃時出現視覺不自然感,影響特定裝置在 OS 升級後的表現
為儲存空間模組新增 KMP 通用 API (往返
ByteArray,而非 JavaInputStream/OutputStream)。新增
BrushBehavior.developerComment屬性來保存中繼資料,說明自訂筆刷系列的設計。這是為了支援筆刷設計工具 UI。修正
CanvasInProgressStrokesRenderHelperV33中執行緒一致性檢查的錯誤。修正處理
MotionEvent選項欄位 (例如傾斜、壓力) 時的部分錯誤。改善自訂筆刷 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 變更
修正錯誤
- 修正特定裝置使用
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)
修正錯誤
- 修正 API 29-32 從視窗卸離/重新附加後,導致
InProgressStrokesView發生當機的錯誤,允許 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 版包含這些修訂項目。
修正錯誤
- 將
graphics-core的依附元件版本提高至 1.0.4 (Ibfa18)
1.0.0-rc01 版
2025 年 12 月 3 日
發布 androidx.ink:ink-*:1.0.0-rc01。1.0.0-rc01 版本包含這些修訂版本。
修正錯誤
- 更新依附元件版本。(Iecd04)
1.0.0-beta02 版
2025 年 11 月 19 日
發布 androidx.ink:ink-*:1.0.0-beta02。1.0.0-beta02 版包含這些修訂項目。
API 變更
- 實驗性自訂低延遲形狀 API,修正各種錯誤 (Ib8d2f)
修正錯誤
- 提升
StrokeInputBatch序列化的浮點精確度,修正重複編碼和解碼導致的值漂移問題 - 更完善的系統輸入內容清理機制。
- 修正
InProgressStrokes可組合函式中的筆刷紋理支援
1.0.0-beta01 版
October 22, 2025
發布 androidx.ink:ink-*:1.0.0-beta01。1.0.0-beta01 版包含這些修訂項目。
修正錯誤
- 修正錯誤,為 beta01 版本做準備 (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)
修正錯誤
- 改善輸入模型,讓筆劃更準確反映輸入內容。(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)
修正錯誤
- 修正效能問題,以及乾濕顏色不一致的問題。(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採用可為空值的不可變動 Box,而非可變動的BoxAccumulator,為了更清楚地瞭解變動內容,呼叫端應將boxAccumulator.add(other)變更為boxAccumulator.add(other.box)。BrushUtil.toBuilderWithAndroidColor/createBuilderWithAndroidColor已移除,請改用建構後的Brush.BuildersetAndroidColor。(Ia7155) - 先前實驗性的屬性
InProgressStrokesView.textureBitmapStore現已設為不公開。這個屬性仍有公開存取子。(I1d706)
修正錯誤
- 提升含有多個粒子的自訂筆刷效能。
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。呼叫端應改為直接檢查 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繪製完成的筆墨筆劃,做為應用程式使用者介面的一部分。 - 筆劃:用於筆跡功能的核心資料類型。
- 筆刷:可設定的規格,決定筆觸的外觀和對使用者輸入內容的反應。
- 幾何圖形:交集和涵蓋範圍等幾何圖形運算,可支援選取和清除等工具。