escrever

Declarar dependências

Para adicionar uma dependência a 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-alpha01"
    implementation "androidx.ink:ink-authoring-compose:1.1.0-alpha01"
    implementation "androidx.ink:ink-brush:1.1.0-alpha01"
    implementation "androidx.ink:ink-brush-compose:1.1.0-alpha01"
    implementation "androidx.ink:ink-geometry:1.1.0-alpha01"
    implementation "androidx.ink:ink-geometry-compose:1.1.0-alpha01"
    implementation "androidx.ink:ink-nativeloader:1.1.0-alpha01"
    implementation "androidx.ink:ink-rendering:1.1.0-alpha01"
    implementation "androidx.ink:ink-storage:1.1.0-alpha01"
    implementation "androidx.ink:ink-strokes:1.1.0-alpha01"
    
}

dependencies {


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

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.

Versão 1.1

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 inclui estes commits.

Novos recursos

• Várias pequenas correções de bugs

Mudanças na API

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

Correções de bugs

• Correção de um bug que causava falhas em InProgressStrokesView após desanexar/reanexar da janela para a API 29-32, permitindo que as operações Vec usassem o mesmo MutableVec como entrada e saída, mesclando as configurações do Proguard em um arquivo. (Ia4da0)
• Aumento da 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 essas confirmações (link em inglês).

Correções de bugs

• Aumento da dependência do graphics-core para 1.0.4 (Ibfa18)

Versão 1.0.0-rc01

3 de dezembro de 2025

Lançamento de androidx.ink:ink-*:1.0.0-rc01. A versão 1.0.0-rc01 contém estas confirmações.

Correções de bugs

• Atualização da 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 estas confirmações.

Mudanças na API

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

Correções de bugs

• Melhoria da 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 estas confirmações.

Correções de bugs

• Correções de bugs em preparação para o lançamento da versão beta01 (I9900e)
• Redução de artefatos de renderização em traços devido a muitas 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 estas confirmações.

Novos recursos

• Parâmetro SelfOverlap para StockBrushes highlighter e emojiHighlighter, que substitui InProgressStrokesView rendererFactory
• Implementação aprimorada da suavização de entrada de traço, que elimina o ruído de medição do dispositivo, mas que reflete com mais precisão a entrada do usuário do que a implementação anterior de suavização de entrada de traço
• Consistência aprimorada 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

• Mudança da API relacionada ao ângulo para usar graus e incluir unidades em nomes, clareza sobre unidades em utilitários de conversão de ângulo e suporte a graus e radianos, mudança da API StockBrushes para usar a versão do pincel de estoque como um parâmetro de função de fábrica e expor o controle de comportamento de sobreposição automática para pincéis de marcador de texto, renomeação de MutableAffineTransform.populateFromTranslate para populateFromTranslation, remoção de InProgressStrokesView.setRenderFactory/getRenderFactory. (Id9eab, b/436656418)
• Renomeação de cisalhamento para inclinação, esclarecimento de algumas documentações, remoção de CanvasStrokeRenderer.strokeModifiedRegionOutsetPx, adição de InProgressStroke.changesWithTime (Ia5e70, b/436656418)

Correções de bugs

• Melhoria da modelagem de entrada para que os traços reflitam com mais precisão a entrada. (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 estas confirmações.

Novos recursos

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

Mudanças na API

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

Correções de bugs

• Correção de um problema de desempenho e de consistência de cores úmidas/secas. (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 estas confirmações.

Novos recursos

• Módulos de interoperabilidade do Compose para criação, pincel e geometria

Mudanças na API

• Novos módulos e APIs de interoperabilidade do Compose, limpeza da 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 foi criado para usar uma caixa imutável anulável em vez de um BoxAccumulator mutável, para deixar mais claro o que é mutado. Os autores da chamada precisam mudar boxAccumulator.add(other) para boxAccumulator.add(other.box). BrushUtil.toBuilderWithAndroidColor/createBuilderWithAndroidColor foram 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

• Melhoria do desempenho de pincéis personalizados que contêm 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 estas confirmações (link em inglês).

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 o carregamento de 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 estas confirmações.

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 uma 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 estas confirmações.

Mudanças na API

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

Contribuição externa

• O uso de BuildCompat.isAtLeastV foi descontinuado. Os autores da chamada precisam verificar o 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, renderização e 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 digital avançadas:

• Criação: use InProgressStrokesView para renderização de traços de alto desempenho e baixa latência em tempo real à medida que as entradas são recebidas.
• Renderização: use CanvasStrokeRenderer e ViewStrokeRenderer para desenhar os traços de tinta digitais concluídos como parte da interface do usuário de um app.
• Traços: tipos de dados principais usados para recursos de tinta digital.
• 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 de seleção e apagamento.