手繪功能

  
激發頂尖的觸控筆應用程式。降低開發人員進入門檻，提供高效、優美的觸控書寫體驗。
最近更新時間 穩定版 候選版 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")
}

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

意見回饋

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

建立新問題

詳情請參閱 Issue Tracker 文件。

這個構件沒有任何版本資訊。

1.0 版本

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 版包含這些修訂版本。

新功能

  • 為自訂 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 變更

  • 修正各種錯誤。(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 繪製完成的墨水筆觸，做為應用程式使用者介面的一部分。
  • 筆劃：用於繪圖功能的核心資料類型。
  • 筆刷：可設定的規格，可用於設定筆觸的外觀和行為，以回應使用者輸入內容。
  • 幾何圖形：幾何運算 (例如交集和覆蓋) 到強大工具 (例如選取和擦除)。