墨水

  
打造一流的觸控筆應用程式。降低開發人員門檻，輕鬆打造高效能的精美筆跡體驗。支援 Android 和伺服器端 JVM 上的墨水筆跡 (目前支援 Linux 的 x86_64)。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2026 年 9 月 9 日 1.0.0 - - 1.1.0-alpha08

宣告依附元件

如要為 Ink 新增依附元件，必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

Groovy

dependencies {
  
    implementation "androidx.ink:ink-authoring:1.1.0-alpha04"
    implementation "androidx.ink:ink-authoring-compose:1.1.0-alpha04"
    implementation "androidx.ink:ink-brush:1.1.0-alpha04"
    implementation "androidx.ink:ink-brush-compose:1.1.0-alpha04"
    implementation "androidx.ink:ink-geometry:1.1.0-alpha04"
    implementation "androidx.ink:ink-geometry-compose:1.1.0-alpha04"
    implementation "androidx.ink:ink-nativeloader:1.1.0-alpha04"
    implementation "androidx.ink:ink-rendering:1.1.0-alpha04"
    implementation "androidx.ink:ink-storage:1.1.0-alpha04"
    implementation "androidx.ink:ink-strokes:1.1.0-alpha04"
    
}

Kotlin

dependencies {


    implementation("androidx.ink:ink-authoring:1.1.0-alpha04")
    implementation("androidx.ink:ink-authoring-compose:1.1.0-alpha04")
    implementation("androidx.ink:ink-brush:1.1.0-alpha04")
    implementation("androidx.ink:ink-brush-compose:1.1.0-alpha04")
    implementation("androidx.ink:ink-geometry:1.1.0-alpha04")
    implementation("androidx.ink:ink-geometry-compose:1.1.0-alpha04")
    implementation("androidx.ink:ink-nativeloader:1.1.0-alpha04")
    implementation("androidx.ink:ink-rendering:1.1.0-alpha04")
    implementation("androidx.ink:ink-storage:1.1.0-alpha04")
    implementation("androidx.ink:ink-strokes:1.1.0-alpha04")
}

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件。

Ink 1.1 版

1.1.0-alpha08 版本

2026 年 9 月 9 日

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

API 變更

  • 透過 MetalRenderer，在選擇加入註解 ExperimentalInkCrossPlatformRenderingApi 下，根據 KMP 通用 API 新增 KMP iOS 的算繪支援，以提供核心功能
  • 將 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 型別，而非 Floats (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 變更

  • 已將 calculateMinimumRequiredVersion 方法新增至 BrushFamily 子類型的 API。(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 變更

  • 實驗性發布新橡皮擦類型，又稱為「部分筆觸」、「網格編輯」或「像素」橡皮擦，可編輯筆觸幾何圖形和分割筆觸，而不是刪除整個筆觸或以背景顏色遮蓋筆觸。已知問題包括：剪裁邊緣缺少反鋸齒功能，以及沒有可儲存已清除 PartitionedMesh 結果的序列化 API，這兩項功能都會在日後版本中推出。
  • 在 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 變更

  • 修正浮點數精確度問題，避免完成的筆觸出現視覺效果瑕疵，影響作業系統升級後的特定裝置

  • 為儲存空間模組新增 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 版包含這些修訂項目。

修正錯誤

  • 修正錯誤，為發布 Beta 版 01 做準備 (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)
  • 將剪切重新命名為傾斜、釐清部分說明文件、移除 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 繪製完成的筆跡，做為應用程式使用者介面的一部分。
  • 筆劃：用於手寫筆跡功能的核心資料類型。
  • 筆刷：可設定筆觸的外觀和動作，以回應使用者輸入內容。
  • 幾何：交集和涵蓋範圍等幾何運算，可支援選取和清除等工具。