墨水

  
激發靈感,打造頂尖手寫筆應用程式。降低開發人員門檻,打造高效能、美觀的筆跡體驗。支援 Android、iOS (15.0 以上版本) 和 JVM (Linux x86-64、ARM64 和 Mac ARM64)。
最近更新時間 穩定版 候選版 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,而非 Java InputStream/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 變更

  • 公開程式輔助墨水筆刷自訂 API (I8e2e1)
  • 將 BrushPaint.TextureLayer 分割為更具體的子類別 (I8848a)

1.1.0-alpha02 版本

2026 年 4 月 22 日

發布 androidx.ink:ink-*:1.1.0-alpha02。1.1.0-alpha02 版包含這些修訂項目。

API 變更

  • 公開 BrushFamily.decode 的超載,指定最大版本相容性 (I1c7bc)
  • BrushFamily 序列化 API 脫離實驗階段 (Idd16e)

修正錯誤

  • 修正特定裝置使用 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 版包含這些修訂項目。

新功能

  • StockBrushes highlighter 和 emojiHighlighter 的 SelfOverlap 參數,取代 InProgressStrokesView rendererFactory
  • 改善筆劃輸入平滑化的實作,消除裝置測量雜訊,但比先前的筆劃輸入平滑化實作更準確地反映使用者輸入
  • 改善與其他 Android/Jetpack API 的一致性,包括角度單位 (度與弧度)、轉換 (傾斜與剪切) 等

API 變更

  • 變更角度相關 API,改用度數並在名稱中加入單位;在角度轉換公用程式中明確指定單位,並支援度數和弧度;變更 StockBrushes API,將現成筆刷版本做為工廠函式參數,並公開螢光筆刷的自我重疊行為控制項;將 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.Builder setAndroidColor。(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 繪製完成的筆墨筆劃,做為應用程式使用者介面的一部分。
  • 筆劃:用於筆跡功能的核心資料類型。
  • 筆刷:可設定的規格,決定筆觸的外觀和對使用者輸入內容的反應。
  • 幾何圖形:交集和涵蓋範圍等幾何圖形運算,可支援選取和清除等工具。