inchiostro

Dichiara le dipendenze

Per aggiungere una dipendenza da Ink, devi aggiungere il repository Maven di Google al tuo progetto. Per saperne di più, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle per la tua app o il tuo modulo:

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

Per saperne di più sulle dipendenze, consulta Aggiungi dipendenze di build.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa libreria. Prima di segnalare un nuovo problema, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Crea un nuovo problema

Per ulteriori informazioni, consulta la documentazione di Issue Tracker.

Non sono disponibili note di rilascio per questo artefatto.

Versione 1.0

Versione 1.0.0-beta01

22 ottobre 2025

androidx.ink:ink-*:1.0.0-beta01 è stato rilasciato. La versione 1.0.0-beta01 contiene questi commit.

Correzioni di bug

• Correzioni di bug in preparazione della release beta01 (I9900e)
• Riduce gli artefatti di rendering nei tratti dovuti a un numero eccessivo di input modellati troppo vicini tra loro.
• Correzione di un raro arresto anomalo nella modellazione dell'input.

Versione 1.0.0-alpha07

8 ottobre 2025

androidx.ink:ink-*:1.0.0-alpha07 è stato rilasciato. La versione 1.0.0-alpha07 contiene questi commit.

Nuove funzionalità

• Parametro SelfOverlap per StockBrushes highlighter e emojiHighlighter, che sostituisce InProgressStrokesView rendererFactory
• Implementazione migliorata del livellamento dell'input tratto, che elimina il rumore di misurazione del dispositivo, ma che riflette l'input utente in modo più accurato rispetto all'implementazione precedente
• Maggiore coerenza con altre API Android/Jetpack per unità di angolo (gradi e radianti), trasformazioni (inclinazione e taglio) e altro ancora

Modifiche alle API

• Modifica l'API relativa all'angolo in modo che utilizzi i gradi e includa l'unità nei nomi, specifica chiaramente le unità nelle utilità di conversione degli angoli e supporta sia i gradi che i radianti, modifica l'API StockBrushes in modo che accetti la versione del pennello stock come parametro della funzione di fabbrica ed esponga il controllo del comportamento di auto-sovrapposizione per i pennelli evidenziatori, rinomina MutableAffineTransform.populateFromTranslate in populateFromTranslation, rimuovi InProgressStrokesView.setRenderFactory/getRenderFactory. (Id9eab, b/436656418)
• Rinomina taglio in inclinazione, chiarisci la documentazione, rimuovi CanvasStrokeRenderer.strokeModifiedRegionOutsetPx, aggiungi InProgressStroke.changesWithTime (Ia5e70, b/436656418)

Correzioni di bug

• Migliora la modellazione dell'input per fare in modo che i tratti riflettano in modo più accurato l'input. (I93097)

Versione 1.0.0-alpha06

13 agosto 2025

androidx.ink:ink-*:1.0.0-alpha06 è stato rilasciato. La versione 1.0.0-alpha06 contiene questi commit.

Nuove funzionalità

• Pennello stock Evidenziatore emoji: evidenzia le parti di un documento con l'emoji che preferisci per aggiungere un tocco divertente e rimanere organizzato.
• Altre API helper per le forme primitive del modulo di geometria
• Migliorare la compatibilità e le prestazioni dei dispositivi

Modifiche alle API

• API semplificata per InProgressStrokesView, API di geometria di finitura, evidenziatore di emoji, rimozione delle funzioni di fabbrica da MutableParallelogram a favore dei metodi di compilazione, supporto del seme per i comportamenti del pennello randomizzati. (I38280)

Correzioni di bug

• Correzione di un problema di prestazioni e di un problema di coerenza del colore bagnato/asciutto. (Ifcd1d)

Versione 1.0.0-alpha05

18 giugno 2025

androidx.ink:ink-*:1.0.0-alpha05 viene rilasciata. La versione 1.0.0-alpha05 contiene questi commit.

Nuove funzionalità

• Composizione di moduli di interoperabilità per i moduli di creazione, pennello e geometria

Modifiche alle API

• Nuovi moduli e API di interoperabilità di Compose, cleanup delle API (I0e464)
• I metodi InProgressStroke.enqueueInputs/updateShape che hanno restituito kotlin.Result vengono rimossi. I client devono utilizzare, ad esempio, enqueueInputsOrThrow o enqueueInputsOrIgnore. InProgressStroke.getNeedsUpdate è stato rinominato in isUpdateNeeded. InProgressStroke.populateOutlinePosition ora restituisce il parametro di output per consentire l'incatenamento delle chiamate, in modo coerente con gli altri metodi in Ink. L'interfaccia TextureBitmapStore viene spostata dal modulo di rendering al modulo del pennello. BoxAccumulator.populateFrom è progettato per accettare una casella immutabile nullable anziché un BoxAccumulator mutabile, per rendere più chiaro cosa viene modificato. I chiamanti devono modificare boxAccumulator.add(other) in boxAccumulator.add(other.box). BrushUtil.toBuilderWithAndroidColor/createBuilderWithAndroidColor vengono rimossi; utilizza invece setAndroidColor di Brush.Builder dopo la costruzione. (Ia7155)
• La proprietà precedentemente sperimentale InProgressStrokesView.textureBitmapStore è ora privata. Esistono ancora accessor pubblici per questa proprietà. (I1d706)

Correzioni di bug

• Prestazioni migliorate per i pennelli personalizzati contenenti molte particelle.

Versione 1.0.0-alpha04

9 aprile 2025

androidx.ink:ink-*:1.0.0-alpha04 viene rilasciata. La versione 1.0.0-alpha04 contiene questi commit.

Nuove funzionalità

• Introduce nuove API sperimentali per gli oggetti BrushFamily personalizzati, consentendo nuovi pennelli come Matita e Puntatore laser. L'API consente di caricare i pennelli definiti da questo proto. (I8809a)

Versione 1.0.0-alpha03

12 febbraio 2025

androidx.ink:ink-*:1.0.0-alpha03 viene rilasciata. La versione 1.0.0-alpha03 contiene questi commit.

Nuove funzionalità

• Risparmio di spazio su disco e di rete: serializzazione di StrokeInputBatch, risparmio di molte righe di codice, con gli oggetti risultanti che rappresentano una piccola frazione delle dimensioni dei tratti memorizzati tradizionalmente. (Ie898d)
• Selezione a lazo: pennello a linea tratteggiata per disegnare un tratto di selezione e una funzione per trasformare il tratto di selezione in un PartitionedMesh per le query sulla geometria. (Ia38a0)

Versione 1.0.0-alpha02

11 dicembre 2024

androidx.ink:ink-*:1.0.0-alpha02 viene rilasciata. La versione 1.0.0-alpha02 contiene questi commit.

Modifiche alle API

• Correzioni di bug vari. (I05dd8)

Contributo esterno

• Depreca BuildCompat.isAtLeastV. I chiamanti devono controllare SDK_INT rispetto a 35 direttamente. (I294d1)

Versione 1.0.0-alpha01

2 ottobre 2024

androidx.ink:ink-*:1.0.0-alpha01 viene rilasciata. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

• Una libreria modulare e configurabile per creare, visualizzare e manipolare facilmente tratti di inchiostro creati nella tua applicazione.

Modifiche alle API

Nuovi moduli per aiutare gli sviluppatori a creare esperienze di inchiostrazione avanzate:

• Creazione: utilizza InProgressStrokesView per il rendering a bassa latenza e ad alte prestazioni dei tratti in tempo reale man mano che vengono ricevuti gli input.
• Rendering: utilizza CanvasStrokeRenderer e ViewStrokeRenderer per disegnare i tratti di inchiostro finiti come parte dell'interfaccia utente di un'app.
• Tratti: tipi di dati principali utilizzati per le funzionalità di inchiostrazione digitale.
• Pennello: specifica configurabile di come appariranno e si comporteranno i tratti in risposta all'input dell'utente.
• Geometria: operazioni geometriche come intersezione e copertura per potenziare strumenti come la selezione e la cancellazione.