atrament

Deklarowanie zależności

Aby dodać zależność od Ink, musisz dodać do projektu repozytorium Maven Google. Więcej informacji znajdziesz w repozytorium Maven Google.

Dodaj zależności od potrzebnych artefaktów w pliku build.gradle aplikacji lub modułu:

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

dependencies {


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

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Prześlij opinię

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli znajdziesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nowy problem, zapoznaj się z istniejącymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk gwiazdki.

Utwórz nowy problem

Więcej informacji znajdziesz w dokumentacji narzędzia do śledzenia problemów Issue Tracker documentation.

Atrament w wersji 1.1

Wersja 1.1.0-alpha03

19 maja 2026 r.

Publikacja androidx.ink:ink-*:1.1.0-alpha03 Wersja 1.1.0-alpha03 zawiera te commity.

Zmiany w interfejsie API

• Udostępnienie interfejsu API do programowego dostosowywania pędzla atramentowego (I8e2e1)
• Podział BrushPaint.TextureLayer na bardziej szczegółowe podklasy (I8848a)

Wersja 1.1.0-alpha02

22 kwietnia 2026 r.

Publikacja androidx.ink:ink-*:1.1.0-alpha02 Wersja 1.1.0-alpha02 zawiera te commity.

Zmiany w interfejsie API

• Udostępnienie przeciążenia BrushFamily.decode, które określa maksymalną zgodność wersji (I1c7bc)
• Przeniesienie interfejsu API serializacji BrushFamily z wersji eksperymentalnej (Idd16e)

Poprawki błędów

• Naprawiono migotanie podczas używania InProgressStrokesView.maskPath na niektórych urządzeniach (I1c7bc, b/496920044)

Wersja 1.1.0-alpha01

11 marca 2026 r.

Publikacja androidx.ink:ink-*:1.1.0-alpha01 Wersja 1.1.0-alpha01 zawiera te commity.

Nowe funkcje

• Różne drobne poprawki błędów

Zmiany w interfejsie API

• Dodanie InProgressShape.isCanceled, naprawienie problemów z współbieżnością w module tworzenia. (Ibfd32, b/474385518, b/470695777)
• Udostępnienie w Javie wersji CanvasStrokeRenderer.create i InProgressStroke.updateShape bez argumentów (Id80a1, b/457715938)

Poprawki błędów

• Naprawiono błąd powodujący awarie w InProgressStrokesView po odłączeniu i ponownym podłączeniu do okna w przypadku interfejsu API 29–32, umożliwiono operacjom wektorowym przyjmowanie tego samego MutableVec jako danych wejściowych i wyjściowych, scalono konfiguracje Proguard w jeden plik. (Ia4da0)
• Zwiększono zależność od graphics-core do wersji 1.0.4 (Ibfa18)

Wersja 1.0

Wersja 1.0.0

17 grudnia 2025 r.

Publikacja androidx.ink:ink-*:1.0.0 Wersja 1.0.0 zawiera te commity.

Poprawki błędów

• Zwiększono zależność od graphics-core do wersji 1.0.4 (Ibfa18)

Wersja 1.0.0-rc01

3 grudnia 2025 r.

Publikacja androidx.ink:ink-*:1.0.0-rc01 Wersja 1.0.0-rc01 zawiera te commity.

Poprawki błędów

• Zaktualizowano wersję zależności. (Iecd04)

Wersja 1.0.0-beta02

19 listopada 2025 r.

Publikacja androidx.ink:ink-*:1.0.0-beta02 Wersja 1.0.0-beta02 zawiera te commity.

Zmiany w interfejsie API

• Eksperymentalne interfejsy API kształtów o niskim opóźnieniu, różne poprawki błędów (Ib8d2f)

Poprawki błędów

• Poprawiono precyzję zmiennoprzecinkową w serializacji StrokeInputBatch, co eliminuje dryfowanie wartości spowodowane powtarzającym się kodowaniem i dekodowaniem.
• Bardziej niezawodne czyszczenie danych wejściowych systemu.
• Naprawiono obsługę tekstury pędzla w komponencie InProgressStrokes.

Wersja 1.0.0-beta01

22 października 2025 r.

Publikacja androidx.ink:ink-*:1.0.0-beta01 Wersja 1.0.0-beta01 zawiera te commity.

Poprawki błędów

• Poprawki błędów przygotowujące do wydania wersji beta01 (I9900e)
• Zmniejszono liczbę artefaktów renderowania w pociągnięciach spowodowanych zbyt dużą liczbą modelowanych danych wejściowych znajdujących się zbyt blisko siebie.
• Naprawiono rzadki przypadek awarii podczas modelowania danych wejściowych.

Wersja 1.0.0-alpha07

8 października 2025 r.

Publikacja androidx.ink:ink-*:1.0.0-alpha07 Wersja 1.0.0-alpha07 zawiera te commity.

Nowe funkcje

• Parametr SelfOverlap dla StockBrushes highlighter i emojiHighlighter, który zastępuje InProgressStrokesView rendererFactory
• Ulepszona implementacja wygładzania danych wejściowych pociągnięć, która eliminuje szumy pomiarowe urządzenia, ale dokładniej odzwierciedla dane wejściowe użytkownika niż poprzednia implementacja wygładzania danych wejściowych pociągnięć.
• Poprawiona spójność z innymi interfejsami API Androida i Jetpacka w zakresie jednostek kątowych (stopnie vs. radiany), przekształceń (pochylenie vs. ścinanie) i innych elementów.

Zmiany w interfejsie API

• Zmiana interfejsu API związanego z kątami na używanie stopni i uwzględnianie jednostki w nazwach, jasne określenie jednostek w narzędziach do konwersji kątów i obsługa zarówno stopni, jak i radianów, zmiana interfejsu API StockBrushes na przyjmowanie wersji pędzla standardowego jako parametru funkcji fabrycznej i udostępnianie kontroli zachowania nakładania się w przypadku pędzli zakreślaczy, zmiana nazwy MutableAffineTransform.populateFromTranslate na populateFromTranslation, usunięcie InProgressStrokesView.setRenderFactory/getRenderFactory. (Id9eab, b/436656418)
• Zmiana nazwy ścinania na pochylenie, doprecyzowanie dokumentacji, usunięcie CanvasStrokeRenderer.strokeModifiedRegionOutsetPx, dodanie InProgressStroke.changesWithTime (Ia5e70, b/436656418)

Poprawki błędów

• Ulepszono modelowanie danych wejściowych, aby pociągnięcia dokładniej odzwierciedlały dane wejściowe. (I93097)

Wersja 1.0.0-alpha06

13 sierpnia 2025 r.

Publikacja androidx.ink:ink-*:1.0.0-alpha06 Wersja 1.0.0-alpha06 zawiera te commity.

Nowe funkcje

• Pędzel standardowy zakreślacza emotikonów: umożliwia wyróżnianie części dokumentu za pomocą dowolnego emotikonu, aby dodać zabawny akcent i ułatwić organizację.
• Więcej interfejsów API pomocniczych dla kształtów pierwotnych modułu geometrii.
• Poprawiono zgodność i wydajność urządzenia.

Zmiany w interfejsie API

• Uproszczony interfejs API dla InProgressStrokesView, dokończenie interfejsów API geometrii, zakreślacza emotikonów, usunięcie funkcji fabrycznych z MutableParallelogram na rzecz metod wypełniania, obsługa materiału wyjściowego dla losowych zachowań pędzla. (I38280)

Poprawki błędów

• Naprawiono problem z wydajnością i spójnością kolorów mokrych i suchych. (Ifcd1d)

Wersja 1.0.0-alpha05

18 czerwca 2025 r.

Publikacja androidx.ink:ink-*:1.0.0-alpha05 Wersja 1.0.0-alpha05 zawiera te commity.

Nowe funkcje

• Moduły interoperacyjności Compose dla modułów tworzenia, pędzla i geometrii.

Zmiany w interfejsie API

• Nowe moduły i interfejsy API interoperacyjności Compose, czyszczenie interfejsu API (I0e464)
• Usunięto metody InProgressStroke.enqueueInputs/updateShape, które zwracały kotlin.Result.Klienci powinni zamiast nich używać np. enqueueInputsOrThrow lub enqueueInputsOrIgnore. Nazwa InProgressStroke.getNeedsUpdate została zmieniona na isUpdateNeeded. Metoda InProgressStroke.populateOutlinePosition zwraca teraz swój parametr wyjściowy, aby umożliwić łączenie wywołań, co jest zgodne z innymi metodami w atramencie. Interfejs TextureBitmapStore został przeniesiony z modułu renderowania do modułu pędzla. BoxAccumulator.populateFrom przyjmuje teraz niezmienny obiekt Box z możliwością wartości null zamiast zmiennego obiektu BoxAccumulator, aby wyraźniej wskazywać, co jest zmieniane. Wywołujący powinni zmienić boxAccumulator.add(other) na boxAccumulator.add(other.box). Usunięto metody BrushUtil.toBuilderWithAndroidColor/createBuilderWithAndroidColor. Zamiast nich po utworzeniu użyj metody setAndroidColor klasy Brush.Builder. (Ia7155)
• Właściwość eksperymentalna InProgressStrokesView.textureBitmapStore jest teraz prywatna. Nadal istnieją publiczne metody dostępu do tej właściwości. (I1d706)

Poprawki błędów

• Poprawiono wydajność w przypadku pędzli niestandardowych zawierających wiele cząstek.

Wersja 1.0.0-alpha04

9 kwietnia 2025 r.

Publikacja androidx.ink:ink-*:1.0.0-alpha04 Wersja 1.0.0-alpha04 zawiera te commity.

Nowe funkcje

• Wprowadzono nowe eksperymentalne interfejsy API dla niestandardowych obiektów BrushFamily, które umożliwiają tworzenie nowych pędzli, takich jak ołówek i wskaźnik laserowy. Interfejs API umożliwia wczytywanie pędzli zdefiniowanych przez ten protokół. (I8809a)

Wersja 1.0.0-alpha03

12 lutego 2025 r.

Publikacja androidx.ink:ink-*:1.0.0-alpha03 Wersja 1.0.0-alpha03 zawiera te commity.

Nowe funkcje

• Oszczędność miejsca na dysku i w sieci: serializacja StrokeInputBatch, oszczędność wielu wierszy kodu, a wynikowe obiekty stanowią niewielki ułamek rozmiaru tradycyjnie przechowywanych pociągnięć. (Ie898d)
• Zaznaczanie lasso: pędzel linii przerywanej do rysowania pociągnięcia zaznaczenia i funkcja przekształcania pociągnięcia zaznaczenia w PartitionedMesh na potrzeby zapytań geometrycznych. (Ia38a0)

Wersja 1.0.0-alpha02

11 grudnia 2024 r.

Publikacja androidx.ink:ink-*:1.0.0-alpha02 Wersja 1.0.0-alpha02 zawiera te commity.

Zmiany w interfejsie API

• Różne poprawki błędów. (I05dd8)

Wkład zewnętrzny

• Wycofanie BuildCompat.isAtLeastV. Wywołujący powinni zamiast tego bezpośrednio sprawdzać SDK_INT względem 35. (I294d1)

Wersja 1.0.0-alpha01

2 października 2024 r.

Publikacja androidx.ink:ink-*:1.0.0-alpha01 Wersja 1.0.0-alpha01 zawiera te commity.

Nowe funkcje

• Modularna i konfigurowalna biblioteka, która ułatwia tworzenie, renderowanie i manipulowanie pięknymi pociągnięciami atramentu w aplikacji.

Zmiany w interfejsie API

Nowe moduły, które pomagają deweloperom tworzyć bogate aplikacje do rysowania:

• Tworzenie: używaj InProgressStrokesView do renderowania pociągnięć w czasie rzeczywistym z niskim opóźnieniem i wysoką wydajnością podczas odbierania danych wejściowych.
• Renderowanie: używaj CanvasStrokeRenderer i ViewStrokeRenderer, aby rysować gotowe pociągnięcia atramentu jako część interfejsu aplikacji.
• Pociągnięcia: podstawowe typy danych używane w funkcjach rysowania.
• Pędzel: konfigurowalna specyfikacja wyglądu i zachowania pociągnięć w odpowiedzi na dane wejściowe użytkownika.
• Geometria: operacje geometryczne, takie jak przecięcie i pokrycie, które umożliwiają korzystanie z narzędzi takich jak zaznaczanie i wymazywanie.