mực

Khai báo phần phụ thuộc

Để thêm một phần phụ thuộc trên Ink, bạn phải thêm kho lưu trữ Google Maven vào dự án. Đọc nội dung Kho lưu trữ Maven của Google để biết thêm thông tin.

Thêm các phần phụ thuộc cho cấu phần phần mềm bạn cần trong tệp build.gradle cho ứng dụng hoặc mô-đun:

dependencies {
  
    implementation "androidx.ink:ink-authoring:1.0.0-beta01"
    implementation "androidx.ink:ink-brush:1.0.0-beta01"
    implementation "androidx.ink:ink-geometry:1.0.0-beta01"
    implementation "androidx.ink:ink-nativeloader:1.0.0-beta01"
    implementation "androidx.ink:ink-rendering:1.0.0-beta01"
    implementation "androidx.ink:ink-strokes:1.0.0-beta01"
    
}

dependencies {


    implementation("androidx.ink:ink-authoring:1.0.0-beta01")
    implementation("androidx.ink:ink-brush:1.0.0-beta01")
    implementation("androidx.ink:ink-geometry:1.0.0-beta01")
    implementation("androidx.ink:ink-nativeloader:1.0.0-beta01")
    implementation("androidx.ink:ink-rendering:1.0.0-beta01")
    implementation("androidx.ink:ink-strokes:1.0.0-beta01")
}

Để biết thêm thông tin về các phần phụ thuộc, hãy xem bài viết Thêm phần phụ thuộc vào bản dựng.

Ý kiến phản hồi

Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.

Báo lỗi mới

Xem tài liệu về Công cụ theo dõi lỗi để biết thêm thông tin.

Không có ghi chú phát hành cho cấu phần phần mềm này.

Phiên bản 1.0

Phiên bản 1.0.0-beta01

Ngày 22 tháng 10 năm 2025

Phát hành androidx.ink:ink-*:1.0.0-beta01. Phiên bản 1.0.0-beta01 bao gồm các thay đổi sau.

Sửa lỗi

• Các bản sửa lỗi để chuẩn bị cho bản phát hành beta01 (I9900e)
• Giảm các hiện tượng kết xuất giả tạo trong nét vẽ do có quá nhiều đầu vào được mô hình hoá quá gần nhau.
• Khắc phục một sự cố hiếm gặp trong quá trình mô hình hoá dữ liệu đầu vào.

Phiên bản 1.0.0-alpha07

Ngày 8 tháng 10 năm 2025

Phát hành androidx.ink:ink-*:1.0.0-alpha07. Phiên bản 1.0.0-alpha07 bao gồm các thay đổi sau.

Tính năng mới

• Tham số SelfOverlap cho StockBrushes highlighter và emojiHighlighter, thay thế InProgressStrokesView rendererFactory
• Cải thiện việc triển khai tính năng làm mượt dữ liệu đầu vào bằng nét vẽ, giúp loại bỏ nhiễu đo lường của thiết bị nhưng phản ánh chính xác hơn dữ liệu đầu vào của người dùng so với việc triển khai tính năng làm mượt dữ liệu đầu vào bằng nét vẽ trước đó
• Cải thiện tính nhất quán với các API Android/Jetpack khác cho các đơn vị góc (độ so với radian), các phép biến đổi (độ lệch so với độ nghiêng) và nhiều API khác

Thay đổi về API

• Thay đổi API liên quan đến góc để sử dụng độ và thêm đơn vị vào tên, làm rõ các đơn vị trong tiện ích chuyển đổi Góc và hỗ trợ cả độ và radian, thay đổi API StockBrushes để lấy phiên bản cọ vẽ có sẵn làm tham số hàm ở trạng thái ban đầu và hiển thị chế độ kiểm soát hành vi tự chồng chéo cho cọ vẽ đánh dấu, đổi tên MutableAffineTransform.populateFromTranslate thành populateFromTranslation, xoá InProgressStrokesView.setRenderFactory/getRenderFactory. (Id9eab, b/436656418)
• Đổi tên thao tác cắt thành thao tác làm xiên, làm rõ một số tài liệu, xoá CanvasStrokeRenderer.strokeModifiedRegionOutsetPx, thêm InProgressStroke.changesWithTime (Ia5e70, b/436656418)

Sửa lỗi

• Cải thiện mô hình hoá dữ liệu đầu vào để các nét vẽ phản ánh chính xác hơn dữ liệu đầu vào. (I93097)

Phiên bản 1.0.0-alpha06

Ngày 13 tháng 8 năm 2025

Phát hành androidx.ink:ink-*:1.0.0-alpha06. Phiên bản 1.0.0-alpha06 bao gồm các thay đổi sau.

Tính năng mới

• Cọ đánh dấu bằng biểu tượng cảm xúc: Đánh dấu các phần của tài liệu bằng bất kỳ biểu tượng cảm xúc nào bạn chọn để thêm nét thú vị và giúp bạn sắp xếp gọn gàng.
• Nhiều API trợ giúp hơn cho các hình dạng cơ bản của mô-đun hình học
• Cải thiện khả năng tương thích và hiệu suất của thiết bị

Thay đổi về API

• Đơn giản hoá API cho InProgressStrokesView, hoàn tất các API hình học, trình đánh dấu biểu tượng cảm xúc, xoá các hàm gốc khỏi MutableParallelogram để chuyển sang các phương thức điền sẵn, hỗ trợ giá trị ban đầu cho các hành vi cọ vẽ ngẫu nhiên. (I38280)

Sửa lỗi

• Khắc phục vấn đề về hiệu suất và vấn đề về độ nhất quán màu khi ướt/khô. (Ifcd1d)

Phiên bản 1.0.0-alpha05

Ngày 18 tháng 6 năm 2025

Phát hành androidx.ink:ink-*:1.0.0-alpha05. Phiên bản 1.0.0-alpha05 bao gồm các thay đổi sau.

Tính năng mới

• Soạn các mô-đun tương tác cho mô-đun tác giả, cọ vẽ và hình học

Thay đổi về API

• Các API và mô-đun mới có khả năng tương tác với Compose, dọn dẹp API (I0e464)
• Các phương thức InProgressStroke.enqueueInputs/updateShape trả về kotlin.Result sẽ bị xoá, thay vào đó, các ứng dụng nên dùng enqueueInputsOrThrow hoặc enqueueInputsOrIgnore. Đổi tên InProgressStroke.getNeedsUpdate thành isUpdateNeeded. InProgressStroke.populateOutlinePosition hiện trả về tham số đầu ra để cho phép liên kết lệnh gọi, nhất quán với các phương thức khác trong Ink. Giao diện TextureBitmapStore được chuyển từ mô-đun kết xuất sang mô-đun cọ vẽ. BoxAccumulator.populateFrom được tạo để lấy một Box không thể thay đổi có giá trị rỗng thay vì BoxAccumulator có thể thay đổi. Để biết rõ hơn về những gì bị thay đổi, người gọi nên thay đổi boxAccumulator.add(other) thành boxAccumulator.add(other.box). BrushUtil.toBuilderWithAndroidColor/createBuilderWithAndroidColor sẽ bị xoá, thay vào đó, hãy dùng setAndroidColor của Brush.Builder sau khi tạo. (Ia7155)
• Thuộc tính thử nghiệm InProgressStrokesView.textureBitmapStore trước đây hiện ở chế độ riêng tư. Vẫn còn các đối tượng truy cập công khai cho tài sản này. (I1d706)

Sửa lỗi

• Cải thiện hiệu suất cho các cọ tuỳ chỉnh chứa nhiều hạt.

Phiên bản 1.0.0-alpha04

Ngày 9 tháng 4 năm 2025

Phát hành androidx.ink:ink-*:1.0.0-alpha04. Phiên bản 1.0.0-alpha04 bao gồm các thay đổi sau.

Tính năng mới

• Giới thiệu các API thử nghiệm mới cho các đối tượng BrushFamily tuỳ chỉnh, cho phép dùng các cọ vẽ mới như Bút chì và Bút chỉ. API này cho phép tải các cọ vẽ do giao thức này xác định. (I8809a)

Phiên bản 1.0.0-alpha03

Ngày 12 tháng 2 năm 2025

Phát hành androidx.ink:ink-*:1.0.0-alpha03. Phiên bản 1.0.0-alpha03 bao gồm các thay đổi sau.

Tính năng mới

• Tiết kiệm dung lượng ổ đĩa và mạng: Nối tiếp hoá StrokeInputBatch, tiết kiệm nhiều dòng mã, với các đối tượng kết quả chỉ bằng một phần nhỏ kích thước của các nét được lưu trữ theo cách truyền thống. (Ie898d)
• Chọn bằng công cụ lasso: cọ vẽ đường nét đứt để vẽ nét chọn và một hàm để chuyển nét chọn thành PartitionedMesh cho các truy vấn hình học. (Ia38a0)

Phiên bản 1.0.0-alpha02

Ngày 11 tháng 12 năm 2024

Phát hành androidx.ink:ink-*:1.0.0-alpha02. Phiên bản 1.0.0-alpha02 bao gồm các thay đổi sau.

Thay đổi về API

• Sửa một số lỗi. (I05dd8)

Đóng góp bên ngoài

• Ngừng sử dụng BuildCompat.isAtLeastV. Thay vào đó, người gọi nên kiểm tra SDK_INT trực tiếp với 35. (I294d1)

Phiên bản 1.0.0-alpha01

Ngày 2 tháng 10 năm 2024

Phát hành androidx.ink:ink-*:1.0.0-alpha01. Phiên bản 1.0.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

• Một thư viện theo mô-đun và có thể định cấu hình để giúp bạn dễ dàng tạo, kết xuất và thao tác với các nét mực đẹp mắt được tạo trong ứng dụng của mình.

Thay đổi về API

Các mô-đun mới giúp nhà phát triển tạo ra trải nghiệm viết tay phong phú:

• Tạo nội dung: Sử dụng InProgressStrokesView để kết xuất nét vẽ theo thời gian thực với hiệu suất cao và độ trễ thấp khi nhận được dữ liệu đầu vào.
• Kết xuất: Sử dụng CanvasStrokeRenderer và ViewStrokeRenderer để vẽ các nét mực đã hoàn thành trong giao diện người dùng của ứng dụng.
• Nét vẽ: Các kiểu dữ liệu cốt lõi được dùng cho các tính năng viết tay.
• Cọ vẽ: Quy cách có thể định cấu hình về cách các nét vẽ sẽ xuất hiện và hoạt động để phản hồi hoạt động đầu vào của người dùng.
• Hình học: Các thao tác hình học như giao điểm và phạm vi phủ sóng để hỗ trợ các công cụ như chọn và xoá.