atrament

  
Inspirowanie najlepszych w swojej klasie aplikacji do obsługi rysika. Ułatwienie deweloperom tworzenia wydajnych i atrakcyjnych wizualnie funkcji pisania odręcznego. Obsługuje Androida, iOS (wersja 15.0 lub nowsza) i JVM (na Linux x86-64 i ARM64 oraz na Mac ARM64).
Najnowsza aktualizacja Wersja stabilna Wersja kandydująca do publikacji Wersja beta Wersja alfa
18 listopada 2026 r. 1.0.0 - - 1.1.0-alpha12

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 dla artefaktów, których potrzebujesz, w pliku build.gradle aplikacji lub modułu:

Dynamiczny

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")
}

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. Daj nam znać, jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki. Przed utworzeniem nowego problemu zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk gwiazdki.

Tworzenie nowego problemu

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Ink w wersji 1.1

Wersja 1.1.0-alpha12

18 listopada 2026 r.

Publikacja androidx.ink:ink-*:1.1.0-alpha12 Wersja 1.1.0-alpha12 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodanie przeciążeń metody Ink InProgressShapesView dla niedokończonych pociągnięć z określonego urządzenia (I9c945)
  • Obsługa wielu urządzeń wejściowych jednocześnie w module tworzenia treści odręcznych (I41ee5)
  • Dodano obsługę JVM linux-aarch64 (I752e5, I1216b).

Poprawki błędów

  • Ograniczenie czasu trwania kształtu pociągnięcia do wartości nieujemnych i monotonicznych (I752e5, b/552666754)
  • Zmień żądaną liczbę klatek w aplikacji CanvasInProgressStrokesRenderHelperV33 na 720F. (I752e5)
  • Zaktualizowano zależność ink-authoring i ink-authoring-compose od input-motionprediction (Ib84ef)

Wersja 1.1.0-alpha11

4 listopada 2026 r.

Publikacja androidx.ink:ink-*:1.1.0-alpha11 Wersja 1.1.0-alpha11 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodano eksperymentalne interfejsy Ink API do obliczania i przechowywania przesunięć fazowych pociągnięć z animowanymi teksturami (I620e6).
  • Dodano eksperymentalne interfejsy API pędzla Ink do określania animowanej tekstury farby (If0f10).
  • Serializacja kształtu pociągnięcia (PartitionedMesh) w celu zapisania częściowo wymazanych pociągnięć lub przyspieszenia wczytywania dokumentu przez zapisanie danych siatki (I1604f)

Poprawki błędów

  • Poprawiliśmy obsługę jednoczesnych danych wejściowych i zgodność z obracaniem rysika. (I0fc23)

Wersja 1.1.0-alpha10

21 października 2026 r.

Publikacja androidx.ink:ink-*:1.1.0-alpha10 Wersja 1.1.0-alpha10 zawiera te zmiany.

Poprawki błędów

  • Dodaj antyaliasing do krawędzi cięcia pociągnięć edytowanych za pomocą gumki do częściowego wymazywania pociągnięć (Stroke.subtract, opcjonalnie z Stroke.split)

Wersja 1.1.0-alpha09

23 września 2026 r.

Publikacja androidx.ink:ink-*:1.1.0-alpha09 Wersja 1.1.0-alpha09 zawiera te zmiany.

Zmiany w interfejsie API

  • Zmieniono przesunięcie koloru pędzla, aby działało w przestrzeni barw Oklab, która lepiej zachowuje postrzeganą jasność przy zmianach odcienia. Zmieniliśmy nazwy interfejsów API SATURATION i LUMINOSITY na odpowiednio CHROMA i LIGHTNESS. (I0ed42)

Poprawki błędów

  • Zależność androidx.lifecycle:lifecycle-runtime została zaktualizowana do wersji 2.10.0. Ta wersja jest wymagana do uruchamiania pakietu kontroli błędów środowiska wykonawczego cyklu życia z AGP w wersji 9.5.0-alpha04 lub nowszej. (I99bfd, b/556807521)

Wersja 1.1.0-alpha08

9 września 2026 r.

Publikacja androidx.ink:ink-*:1.1.0-alpha08 Wersja 1.1.0-alpha08 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaj obsługę renderowania dla KMP na iOS za pomocą MetalRenderer, pod adnotacją akceptacji ExperimentalInkCrossPlatformRenderingApi, na podstawie wspólnych interfejsów API KMP dla głównej funkcjonalności.
  • Zmień nazwę Target.TEXTURE_ANIMATION_PROGRESS_OFFSET na Target.PAINT_ANIMATION_PROGRESS_OFFSET. (I8809f)
  • Dodanie przeciążeń ImmutableAffineTransform.translate(float x, float, y) i MutableAffineTransform populateFromTranslation(float x, float y) (I8809f)
  • Zmień nazwę właściwości DampingNode z dampingSource na dampOver (Id3178)
  • Zmień nazwę właściwości DampingNode z dampingGap na strength (I69432)
  • Podczas definiowania EasingFunction.CubicBezier używaj typu Vec zamiast Float (I69432)
  • Dodanie adnotacji WorkerThread do funkcji gumki do edycji siatki Stroke.subtract i Stroke.split (I69432)

Poprawki błędów

  • thought Zapewnienie zgodności z KMP w przypadku Brush próbek (I77125)

Wersja 1.1.0-alpha07

12 sierpnia 2026 r.

Publikacja androidx.ink:ink-*:1.1.0-alpha07 Wersja 1.1.0-alpha07 zawiera te zmiany.

Zmiany w interfejsie API

  • Naprawiono regresję wydajności, która wpływała na pędzle z gęstymi cząsteczkami, oraz zaktualizowano stałe Brush.Version na podstawie opinii o interfejsie API (I87f0f).

Wersja 1.1.0-alpha06

29 lipca 2026 r.

Publikacja androidx.ink:ink-*:1.1.0-alpha06 Wersja 1.1.0-alpha06 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodano metody calculateMinimumRequiredVersion do interfejsu API dla podtypów BrushFamily. (I338c9)
  • Udostępnij pola komponentu AffineTransform (Ic2ec3)
  • Naprawiono wyciek pamięci w InProgressStrokesView, ulepszono eksperymentalne artefakty wizualne gumki do częściowego wymazywania pociągnięć, ulepszono reprezentację protobuf dla niestandardowych warstw tekstury pędzla (I6ff86)
  • Dodanie konstruktora inicjującego dla MutableAffineTransform (aby dopasować do ImmutableAffineTransform) (I96ec7)
  • Dodaj InProgressStroke.clear (Ie0032)
  • Dodanie metod toImmutable do struktur danych z modyfikowalnymi i niemodyfikowalnymi podklasami (I53835)
  • Migracja KMP (Icbf38, b/521850119, b/534309122)

Poprawki błędów

  • Dodanie dalszej obsługi wersji pędzli i animacji tekstur. (Iea9ba)

Wersja 1.1.0-alpha05

15 lipca 2026 r.

Publikacja androidx.ink:ink-*:1.1.0-alpha05 Wersja 1.1.0-alpha05 zawiera te zmiany.

Zmiany w interfejsie API

  • Eksperymentalna wersja nowego typu gumki, znanej jako „częściowe pociągnięcie”, „edycja siatki” lub „gumka pikselowa”, która edytuje geometrię pociągnięć i dzieli je, zamiast usuwać całe pociągnięcia lub maskować je kolorem tła. Znane problemy to m.in. brak antyaliasingu na krawędziach wyciętych elementów oraz brak interfejsów API serializacji do zapisywania wyników wymazywania PartitionedMesh. Te funkcje zostaną dodane w przyszłych wersjach.
  • Dodaj brakującą adnotację Throws do StrokeInputBatchSerialization.decode, co wymaga aktualizacji od użytkowników tej metody w języku Java. (I83473, b/522256938)

Poprawki błędów

  • Naprawiono awarię systemową spowodowaną problemem z precyzją numeryczną (I2e1f0, 6618e69, b/523190724).
  • Odrzucanie nieprawidłowych wytłoczeń w BrushTipExtruder (469b629)
  • Fix RejectedExecutionException in InProgressStrokesView (b/526696762)

Wersja 1.1.0-alpha04

17 czerwca 2026 r.

Publikacja androidx.ink:ink-*:1.1.0-alpha04 Wersja 1.1.0-alpha04 zawiera te zmiany.

Zmiany w interfejsie API

  • Naprawiliśmy problemy z precyzją liczb zmiennoprzecinkowych, które powodowały powstawanie artefaktów wizualnych w gotowych pociągnięciach i występowały na niektórych urządzeniach po uaktualnieniu systemu operacyjnego.

  • Dodaj interfejs API KMP-common do modułu pamięci masowej (zamiast Java InputStream/OutputStream będzie używany ByteArray).

  • Dodaj właściwość BrushBehavior.developerComment, która będzie zawierać metadane wyjaśniające projekt niestandardowej rodziny pędzli. Ma to na celu obsługę interfejsu Kreatora pędzli.

  • Naprawiliśmy błąd w mechanizmach sprawdzania spójności wątków w CanvasInProgressStrokesRenderHelperV33.

  • Naprawiono błędy w obsłudze pól opcjonalnych MotionEvent (np. nachylenie, nacisk).

  • Ulepszenie dokumentacji interfejsu API pędzla niestandardowego.

  • Dodaj nowe typy BrushPaint.ColorFunction.

Wersja 1.1.0-alpha03

19 maja 2026 r.

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

Zmiany w interfejsie API

  • Udostępnienie publicznie interfejsu API do programowego dostosowywania pędzla Ink (I8e2e1)
  • Podziel klasę 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 zmiany.

Zmiany w interfejsie API

  • Udostępnienie przeciążenia metody BrushFamily.decode, które określa zgodność z maksymalną wersją (I1c7bc)
  • BrushFamily: interfejs API serializacji nie jest już eksperymentalny (Idd16e)

Poprawki błędów

  • Rozwiązano problem z migotaniem podczas korzystania z 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 zmiany.

Nowe funkcje

  • Poprawki różnych drobnych błędów

Zmiany w interfejsie API

  • Dodano InProgressShape.isCanceled, rozwiązano problemy ze współbieżnością w module tworzenia. (Ibfd32, b/474385518, b/470695777)
  • Udostępnienie w języku Java wersji CanvasStrokeRenderer.create i InProgressStroke.updateShape bez argumentów (Id80a1, b/457715938)

Poprawki błędów

  • Naprawiliśmy błąd powodujący awarie w InProgressStrokesView po odłączeniu/ponownym podłączeniu z okna w przypadku interfejsu API 29–32, umożliwiliśmy operacjom Vec przyjmowanie tych samych MutableVec jako danych wejściowych i wyjściowych oraz scaliliśmy 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 zatwierdzenia.

Poprawki błędów

  • Zwiększ 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 zatwierdzenia.

Poprawki błędów

  • Zaktualizuj 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 zatwierdzenia.

Zmiany w interfejsie API

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

Poprawki błędów

  • Poprawiono precyzję liczb zmiennoprzecinkowych w serializacji StrokeInputBatch, co rozwiązało problem z dryfem wartości spowodowanym wielokrotnym kodowaniem i dekodowaniem.
  • bardziej rygorystyczne czyszczenie danych wejściowych systemu;
  • Naprawiono obsługę tekstury pędzla w funkcji kompozycyjnej 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 zatwierdzenia.

Poprawki błędów

  • Poprawki błędów w ramach przygotowań do wersji beta01 (I9900e)
  • Zmniejsz liczbę artefaktów renderowania w pociągnięciach spowodowanych zbyt dużą liczbą modelowanych danych wejściowych, które znajdują się zbyt blisko siebie.
  • Naprawiliśmy rzadką awarię w modelowaniu 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 zmiany.

Nowe funkcje

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

Zmiany w interfejsie API

  • Zmieniono interfejs API związany z kątem, aby używał stopni i uwzględniał jednostkę w nazwach. Wyjaśniono jednostki w narzędziach do konwersji kąta i dodano obsługę zarówno stopni, jak i radianów. Zmieniono interfejs API StockBrushes, aby przyjmował wersję pędzla jako parametr funkcji fabrycznej, i udostępniono kontrolę zachowania nakładania się dla pędzli zakreślacza. Zmieniono nazwę MutableAffineTransform.populateFromTranslate na populateFromTranslation. Usunięto InProgressStrokesView.setRenderFactory/getRenderFactory. (Id9eab, b/436656418)
  • Zmieniono nazwę „shear” na „skew”, doprecyzowano niektóre elementy dokumentacji, usunięto CanvasStrokeRenderer.strokeModifiedRegionOutsetPx, dodano InProgressStroke.changesWithTime (Ia5e70, b/436656418)

Poprawki błędów

  • Ulepszyliśmy 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 zmiany.

Nowe funkcje

  • Pędzel z emotikonami: wyróżniaj części dokumentu za pomocą dowolnych emotikonów, aby dodać zabawny akcent i zachować porządek.
  • Więcej pomocniczych interfejsów API dla kształtów podstawowych modułu geometrii
  • Poprawa zgodności i wydajności urządzenia

Zmiany w interfejsie API

  • Uproszczony interfejs API dla InProgressStrokesView, interfejsy API geometrii wykończenia, wyróżnianie emotikonów, usunięcie funkcji fabrycznych z MutableParallelogram na rzecz metod wypełniania, obsługa danych początkowych w przypadku losowych zachowań pędzla. (I38280)

Poprawki błędów

  • Rozwiązaliśmy problem z wydajnością oraz problem ze spójnością kolorów na mokro i sucho. (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 zmiany.

Nowe funkcje

  • Tworzenie modułów interoperacyjności na potrzeby modułów tworzenia, pędzla i geometrii

Zmiany w interfejsie API

  • Nowe moduły i interfejsy API interoperacyjności Compose, czyszczenie interfejsu API (I0e464)
  • Metody InProgressStroke.enqueueInputs/updateShape, które zwracały kotlin.Result, zostały usunięte.Klienci powinni używać np. enqueueInputsOrThrow lub enqueueInputsOrIgnore. Nazwa InProgressStroke.getNeedsUpdate została zmieniona na isUpdateNeeded. InProgressStroke.populateOutlinePosition zwraca teraz parametr wyjściowy, aby umożliwić łańcuch wywołań, zgodnie z innymi metodami w Ink. Interfejs TextureBitmapStore został przeniesiony z modułu renderowania do modułu pędzla. Funkcja BoxAccumulator.populateFrom przyjmuje teraz niemodyfikowalny obiekt Box, który może mieć wartość null, zamiast modyfikowalnego obiektu BoxAccumulator. Aby było jasne, co jest modyfikowane, wywołujący powinni zmienić boxAccumulator.add(other) na boxAccumulator.add(other.box). Funkcje BrushUtil.toBuilderWithAndroidColor/createBuilderWithAndroidColor zostały usunięte. Zamiast nich używaj funkcji setAndroidColor w Brush.Builder po utworzeniu. (Ia7155)
  • Właściwość InProgressStrokesView.textureBitmapStore, która wcześniej była eksperymentalna, jest teraz prywatna. Nadal istnieją publiczne akcesory tej właściwości. (I1d706)

Poprawki błędów

  • Zwiększona wydajność pędzli niestandardowych zawierających wiele cząsteczek.

Wersja 1.0.0-alpha04

9 kwietnia 2025 r.

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

Nowe funkcje

  • Wprowadzamy nowe eksperymentalne interfejsy API dla niestandardowych obiektów BrushFamily, które umożliwiają korzystanie z nowych pędzli, takich jak ołówek i wskaźnik laserowy. Interfejs API umożliwia wczytywanie pędzli zdefiniowanych przez ten proto. (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 zatwierdzenia.

Nowe funkcje

  • Oszczędność miejsca na dysku i w sieci: serializacja StrokeInputBatch, która pozwala zaoszczędzić wiele wierszy kodu, a wynikowe obiekty stanowią niewielką część rozmiaru tradycyjnie przechowywanych pociągnięć. (Ie898d)
  • Zaznaczenie lassem: pędzel z linią przerywaną do rysowania pociągnięcia zaznaczenia oraz 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 zatwierdzenia.

Zmiany w interfejsie API

  • Poprawki różnych błędów. (I05dd8)

Zewnętrzny wkład

  • Wycofaj: BuildCompat.isAtLeastV. Zamiast tego wywołujący powinni sprawdzać SDK_INT bezpośrednio pod kątem wersji 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 zatwierdzenia.

Nowe funkcje

  • Modułowa i konfigurowalna biblioteka, która ułatwia tworzenie, renderowanie i modyfikowanie pięknych pociągnięć piórem w aplikacji.

Zmiany w interfejsie API

Nowe moduły, które pomagają deweloperom tworzyć rozbudowane funkcje pisania odręcznego:

  • Tworzenie: używaj InProgressStrokesView, aby uzyskać wysoką wydajność i krótki czas oczekiwania podczas renderowania pociągnięć w czasie rzeczywistym po otrzymaniu danych wejściowych.
  • Renderowanie: używaj CanvasStrokeRenderer i ViewStrokeRenderer do rysowania gotowych pociągnięć cyfrowego pióra w ramach interfejsu aplikacji.
  • Pociągnięcia: podstawowe typy danych używane w funkcjach pisania odręcznego.
  • 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.