tinta

Declarar dependências

Para adicionar uma dependência ao Ink, adicione o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para ver mais informações.

Adicione as dependências dos artefatos necessários ao arquivo build.gradle do seu app ou módulo:

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

dependencies {


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

Para mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Ink versão 1.1

Versão 1.1.0-alpha08

9 de setembro de 2026

Lançamento de androidx.ink:ink-*:1.1.0-alpha08. A versão 1.1.0-alpha08 contém estes commits.

Mudanças na API

• Adicione suporte à renderização para KMP iOS via MetalRenderer, na anotação de ativação ExperimentalInkCrossPlatformRenderingApi, com base nas APIs comuns do KMP para funcionalidade principal.
• O Target.TEXTURE_ANIMATION_PROGRESS_OFFSET foi renomeado como Target.PAINT_ANIMATION_PROGRESS_OFFSET. (I8809f).
• Adição de sobrecargas ImmutableAffineTransform.translate(float x, float, y) e MutableAffineTransform populateFromTranslation(float x, float y) (I8809f)
• A propriedade DampingNode foi renomeada de dampingSource para dampOver (Id3178).
• Renomeação da propriedade DampingNode de dampingGap para strength (I69432)
• Use o tipo Vec ao definir EasingFunction.CubicBezier em vez de Floats (I69432)
• Adicione a anotação WorkerThread às funções de borracha de edição de malha Stroke.subtract e Stroke.split (I69432)

Correções de bugs

• Tornar as amostras Brush compatíveis com KMP (I77125)

Versão 1.1.0-alpha07

12 de agosto de 2026

Lançamento de androidx.ink:ink-*:1.1.0-alpha07. A versão 1.1.0-alpha07 contém estes commits.

Mudanças na API

• Correção da regressão de desempenho que afeta pincéis de partículas densas e atualização das constantes Brush.Version com base no feedback da API (I87f0f).

Versão 1.1.0-alpha06

29 de julho de 2026

Lançamento de androidx.ink:ink-*:1.1.0-alpha06. A versão 1.1.0-alpha06 contém estes commits.

Mudanças na API

• Adição de métodos calculateMinimumRequiredVersion à API para subtipos de BrushFamily. (I338c9).
• Exposição dos campos de componentes AffineTransform (Ic2ec3).
• Correção de vazamento de memória em InProgressStrokesView, melhoria nos artefatos visuais experimentais do apagador parcial de traços e melhoria na representação do protobuf para camadas de textura de pincel personalizadas (I6ff86)
• Adição do construtor de inicialização para MutableAffineTransform (para corresponder a ImmutableAffineTransform) (I96ec7).
• Adição de InProgressStroke.clear (Ie0032).
• Adicione métodos toImmutable a estruturas de dados com subclasses mutáveis e imutáveis (I53835)
• Migração do KMP (Icbf38, b/521850119, b/534309122)

Correções de bugs

• Adição de mais suporte para controle de versões de pincéis e animações de textura. (Iea9ba).

Versão 1.1.0-alpha05

15 de julho de 2026

Lançamento de androidx.ink:ink-*:1.1.0-alpha05. A versão 1.1.0-alpha05 contém estes commits.

Mudanças na API

• Lançamento experimental de um novo tipo de borracha, conhecido como "traço parcial", "edição de malha" ou borracha "pixel", que edita a geometria do traço e divide os traços em vez de excluir ou mascarar com a cor de fundo. Os problemas conhecidos incluem a falta de suavização nas bordas cortadas e a ausência de APIs de serialização para salvar os resultados apagados de PartitionedMesh, que serão incluídos em versões futuras.
• Adicione a anotação Throws ausente a StrokeInputBatchSerialization.decode, exigindo uma atualização dos consumidores Java desse método. (I83473, b/522256938)

Correções de bugs

• Correção de uma falha nativa devido a um problema de precisão numérica (I2e1f0, 6618e69, b/523190724).
• Descartar extrusões degeneradas em BrushTipExtruder (469b629)
• Correção de RejectedExecutionException em InProgressStrokesView (b/526696762).

Versão 1.1.0-alpha04

17 de junho de 2026

Lançamento de androidx.ink:ink-*:1.1.0-alpha04. A versão 1.1.0-alpha04 contém estes commits.

Mudanças na API

• Correção de problemas de precisão de ponto flutuante que levavam a artefatos visuais em traços finalizados, afetando determinados dispositivos após upgrades do SO

• Adicione a API KMP-common para o módulo de armazenamento (indo/vindo de ByteArray em vez de Java InputStream/OutputStream).

• Adicione uma propriedade BrushBehavior.developerComment para armazenar metadados que explicam o design de uma família de pincéis personalizada. Isso é para dar suporte à interface do usuário do Designer de pincel.

• Correção de um bug nas verificações de consistência de linhas de execução em CanvasInProgressStrokesRenderHelperV33.

• Correção de alguns bugs no processamento de campos opcionais de MotionEvent (por exemplo, inclinação e pressão).

• Melhoria na documentação da API de pincel personalizado.

• Adicione novos tipos de BrushPaint.ColorFunction.

Versão 1.1.0-alpha03

19 de maio de 2026

Lançamento de androidx.ink:ink-*:1.1.0-alpha03. A versão 1.1.0-alpha03 contém estes commits.

Mudanças na API

• Tornar pública a API de personalização programática do pincel de tinta (I8e2e1)
• Dividir BrushPaint.TextureLayer em subclasses mais específicas (I8848a)

Versão 1.1.0-alpha02

22 abril de 2026

Lançamento de androidx.ink:ink-*:1.1.0-alpha02. A versão 1.1.0-alpha02 contém estes commits.

Mudanças na API

• Expor uma sobrecarga de BrushFamily.decode que especifica a compatibilidade máxima de versão (I1c7bc)
• A API de serialização BrushFamily foi promovida de experimental (Idd16e).

Correções de bugs

• Correção de oscilação ao usar InProgressStrokesView.maskPath em determinados dispositivos (I1c7bc, b/496920044)

Versão 1.1.0-alpha01

11 de março de 2026

Lançamento de androidx.ink:ink-*:1.1.0-alpha01. A versão 1.1.0-alpha01 contém estes commits.

Novos recursos

• Várias pequenas correções de bugs

Mudanças na API

• Adicione InProgressShape.isCanceled e corrija problemas de simultaneidade no módulo de criação. (Ibfd32, b/474385518, b/470695777)
• Exposição da versão de zero argumentos de CanvasStrokeRenderer.create e InProgressStroke.updateShape para Java (Id80a1, b/457715938).

Correções de bugs

• Correção de um bug que causava falhas no InProgressStrokesView após separar/reconectar da janela para as APIs 29 a 32, permitindo que as operações do Vec usassem o mesmo MutableVec como entrada e saída, e mesclagem das configurações do Proguard em um arquivo. (Ia4da0).
• Aumentar a dependência do graphics-core para 1.0.4 (Ibfa18)

Versão 1.0

Versão 1.0.0

17 de dezembro de 2025

Lançamento de androidx.ink:ink-*:1.0.0. A versão 1.0.0 contém estes commits.

Correções de bugs

• Aumentar a dependência de graphics-core para 1.0.4 (Ibfa18)

Versão 1.0.0-rc01

03 de dezembro de 2025

Lançamento de androidx.ink:ink-*:1.0.0-rc01. A versão 1.0.0-rc01 contém estes commits.

Correções de bugs

• Atualiza a versão da dependência. (Iecd04).

Versão 1.0.0-beta02

19 de novembro de 2025

Lançamento de androidx.ink:ink-*:1.0.0-beta02. A versão 1.0.0-beta02 contém estes commits.

Mudanças na API

• APIs experimentais de forma personalizada de baixa latência, várias correções de bugs (Ib8d2f)

Correções de bugs

• Melhoria na precisão de ponto flutuante na serialização StrokeInputBatch, corrigindo um desvio nos valores da codificação e decodificação repetidas.
• Sanitização de entrada do sistema mais robusta.
• Correção do suporte à textura do pincel no elemento combinável InProgressStrokes

Versão 1.0.0-beta01

22 de outubro de 2025

Lançamento de androidx.ink:ink-*:1.0.0-beta01. A versão 1.0.0-beta01 contém estes commits.

Correções de bugs

• Correções de bugs em preparação para o lançamento da versão beta01 (I9900e)
• Reduz os artefatos de renderização em traços devido ao excesso de entradas modeladas muito próximas umas das outras.
• Correção de uma falha rara na modelagem de entrada.

Versão 1.0.0-alpha07

8 de outubro de 2025

Lançamento de androidx.ink:ink-*:1.0.0-alpha07. A versão 1.0.0-alpha07 contém estes commits.

Novos recursos

• Parâmetro SelfOverlap para StockBrushes highlighter e emojiHighlighter, que substitui InProgressStrokesView rendererFactory
• Implementação aprimorada da suavização de entrada de traços, que elimina o ruído de medição do dispositivo, mas reflete com mais precisão a entrada do usuário do que a implementação anterior.
• Melhoria na consistência com outras APIs do Android/Jetpack para unidades de ângulo (graus x radianos), transformações (inclinação x cisalhamento) e muito mais.

Mudanças na API

• Mude a API relacionada a ângulos para usar graus e inclua a unidade nos nomes. Deixe claro as unidades nos utilitários de conversão de ângulos e ofereça suporte a graus e radianos. Mude a API StockBrushes para usar a versão do pincel de estoque como um parâmetro de função de fábrica e exponha o controle de comportamento de auto-sobreposição para pincéis de marca-texto. Renomeie MutableAffineTransform.populateFromTranslate para populateFromTranslation e remova InProgressStrokesView.setRenderFactory/getRenderFactory. (Id9eab, b/436656418)
• Renomeação de "shear" para "skew", esclarecimento de parte da documentação, remoção de CanvasStrokeRenderer.strokeModifiedRegionOutsetPx e adição de InProgressStroke.changesWithTime (Ia5e70, b/436656418).

Correções de bugs

• Melhorar a modelagem de entrada para que os traços reflitam a entrada com mais precisão. (I93097)

Versão 1.0.0-alpha06

13 de agosto de 2025

Lançamento de androidx.ink:ink-*:1.0.0-alpha06. A versão 1.0.0-alpha06 contém estes commits.

Novos recursos

• Pincel de destaque de emojis: destaque partes de um documento com qualquer emoji que você escolher para adicionar um toque divertido e ajudar na organização.
• Mais APIs auxiliares para formas primitivas do módulo de geometria
• Melhorar a compatibilidade e o desempenho do dispositivo

Mudanças na API

• API simplificada para InProgressStrokesView, APIs de geometria de finalização, destaque de emoji, remoção de funções de fábrica de MutableParallelogram em favor de métodos de preenchimento, suporte a sementes para comportamentos aleatórios de pincel. (I38280).

Correções de bugs

• Correção de um problema de desempenho e de consistência de cores em superfícies secas/molhadas. (Ifcd1d).

Versão 1.0.0-alpha05

18 de junho de 2025

Lançamento de androidx.ink:ink-*:1.0.0-alpha05. A versão 1.0.0-alpha05 contém estes commits.

Novos recursos

• Módulos de interoperabilidade do Compose para criação, estilo do pincel e forma geométrica do traço

Mudanças na API

• Novos módulos e APIs de interoperabilidade do Compose, limpeza de API (I0e464)
• Os métodos InProgressStroke.enqueueInputs/updateShape que retornavam kotlin.Result foram removidos. Os clientes precisam usar, por exemplo, enqueueInputsOrThrow ou enqueueInputsOrIgnore. InProgressStroke.getNeedsUpdate foi renomeado para isUpdateNeeded. InProgressStroke.populateOutlinePosition agora retorna o parâmetro de saída para permitir o encadeamento de chamadas, consistente com outros métodos no Ink. A interface TextureBitmapStore foi movida do módulo de renderização para o módulo de pincel. BoxAccumulator.populateFrom é feito para receber uma caixa imutável anulável em vez de um BoxAccumulator mutável. Para deixar mais claro o que é mutado, os chamadores precisam mudar boxAccumulator.add(other) para boxAccumulator.add(other.box). Os BrushUtil.toBuilderWithAndroidColor/createBuilderWithAndroidColor são removidos. Use o setAndroidColor de Brush.Builder após a construção. (Ia7155)
• A propriedade experimental InProgressStrokesView.textureBitmapStore agora é particular. Ainda há acessadores públicos para essa propriedade. (I1d706).

Correções de bugs

• Melhoramos o desempenho para pincéis personalizados com muitas partículas.

Versão 1.0.0-alpha04

9 de abril de 2025

Lançamento de androidx.ink:ink-*:1.0.0-alpha04. A versão 1.0.0-alpha04 contém estes commits.

Novos recursos

• Introdução de novas APIs experimentais para objetos BrushFamily personalizados, permitindo novos pincéis, como lápis e ponteiro laser. A API permite carregar pincéis definidos por esse proto. (I8809a)

Versão 1.0.0-alpha03

12 de fevereiro de 2025

Lançamento de androidx.ink:ink-*:1.0.0-alpha03. A versão 1.0.0-alpha03 contém estes commits.

Novos recursos

• Economia de tamanho de disco e rede: serialização de StrokeInputBatch, economizando muitas linhas de código, com os objetos resultantes sendo uma pequena fração do tamanho dos traços armazenados tradicionalmente. (Ie898d).
• Seleção de laço: pincel de linha tracejada para desenhar um traço de seleção e uma função para transformar o traço de seleção em um PartitionedMesh para consultas de geometria. (Ia38a0).

Versão 1.0.0-alpha02

11 de dezembro de 2024

Lançamento de androidx.ink:ink-*:1.0.0-alpha02. A versão 1.0.0-alpha02 contém estes commits.

Mudanças na API

• Várias correções de bugs. (I05dd8).

Contribuição externa

• O uso de BuildCompat.isAtLeastV foi descontinuado. Em vez disso, os chamadores precisam verificar SDK_INT diretamente em relação a 35. (I294d1).

Versão 1.0.0-alpha01

2 de outubro de 2024

Lançamento de androidx.ink:ink-*:1.0.0-alpha01. A versão 1.0.0-alpha01 inclui estes commits.

Novos recursos

• Uma biblioteca modular e configurável para facilitar a criação, a renderização e a manipulação de traços de tinta bonitos criados no seu aplicativo.

Mudanças na API

Novos módulos para ajudar os desenvolvedores a criar experiências de tinta avançadas:

• Criação: use InProgressStrokesView para renderização de alta performance e baixa latência de traços em tempo real à medida que as entradas são recebidas.
• Renderização: use CanvasStrokeRenderer e ViewStrokeRenderer para desenhar os traços de tinta finalizados como parte da interface do usuário de um app.
• Traços: tipos de dados principais usados para recursos de tinta.
• Pincel: especificação configurável de como os traços vão aparecer e agir em resposta à entrada do usuário.
• Geometria: operações geométricas, como interseção e cobertura, para ferramentas como seleção e apagamento.