O botão lateral com o de aumentar volume captura sua tela. Quando o que está na tela é código, isso quase nunca é o que você quer.

Uma captura de código no celular leva junto a barra de status, a interface do app, a posição de rolagem em que você estava e — o que de fato estraga tudo — a largura do seu telefone em vez da largura de que o seu código precisa. As linhas longas já estão quebradas ou cortadas antes de você apertar qualquer coisa. Você está fotografando um acordo que o telefone fez por você.

A solução no iPhone é a mesma de qualquer lugar: parta do texto, não da tela.

O problema de levar código para um telefone

Esse é o obstáculo honesto, e quase todo guia pula essa parte. No Mac o seu código já está lá. No telefone normalmente não.

Na prática ele chega de quatro jeitos:

  • A área de transferência. A área de transferência universal faz com que o que você copiou no Mac esteja no iPhone um segundo depois. É de longe o caminho mais comum.
  • Uma mensagem para você mesmo. Slack, Mensagens ou uma nota.
  • Um arquivo. Algo no iCloud Drive ou no Arquivos, aberto e copiado.
  • Você escreveu ali. Raro, mas com um editor de código no iPad é plausível.

Os quatro terminam igual: o código é texto no seu telefone, pronto para colar. Esse é o único estado que importa.

Cole em algo que saiba exibir código

O Codeshot roda nativamente no iPhone. O botão de colar é o passo de entrada inteiro: você toca e a área de transferência vira um trecho colorido.

A aba Fonte do Codeshot no iPhone: uma pré-visualização ao vivo em cima e, abaixo, um editor com números de linha, a linguagem detectada e um botão de colar

A linguagem é detectada pelo próprio código entre 60, e o seletor no canto substitui isso quando um trecho curto é ambíguo — três linhas de C e três de C++ são idênticas para qualquer detector. A pré-visualização de cima se atualiza enquanto você mexe, então a imagem que você exporta é a que está vendo.

Como parte do texto, a largura é sua e não do seu telefone. Só essa diferença já explica quase todo o motivo de o resultado ganhar de uma captura.

Escolha um tema com contraste

São 30 temas de sintaxe, cada um com variante clara e escura.

O Codeshot no iPhone com a aba Design: um seletor de tema e uma fileira de amostras de fundo abaixo do trecho renderizado

No telefone essa escolha importa mais do que na mesa, e no sentido contrário ao que a maioria espera. Você não está escolhendo o tema em que gosta de ler em tamanho cheio. Está escolhendo um que sobreviva a ser reduzido no feed de outra pessoa. Temas de alto contraste seguram texto pequeno; os claros mais suaves perdem a estrutura.

O fundo fica atrás da janela: um papel de parede do macOS, um dos 92 gradientes, uma cor sólida, ou nada, se você quiser exportar com transparência.

Dimensione para onde a imagem vai

É aqui que quase toda imagem de código falha, e é um controle só.

O painel Proporção no Codeshot no iPhone, com as opções Original, 1:1, 4:3, 3:2, 16:9, 9:16, 2:3 e 3:4

Deixe em Original e a imagem acompanha o conteúdo. Trave numa proporção e a imagem é completada até aquela forma, que é o que você quer quando o destino corta num quadro fixo — 16:9 para um post de timeline, 9:16 ou 3:4 para um feed vertical, 1:1 quando o trecho é curto e mais quadrado.

Se estiver em dúvida, os guias de tamanho por plataforma cobrem cada destino.

Deixe curto

Dez a quinze linhas é o teto do que se lê bem num telefone, e isso vale em dobro quando quem lê também está no telefone.

Corte até a parte que sustenta o seu argumento antes de colar. Se contexto for mesmo necessário, uma linha de comentário no topo rende mais que vinte linhas de código em volta.

Exporte e compartilhe

Exportar entrega a imagem direto para a folha de compartilhamento do iOS, então ela vai para onde você já ia — Mensagens, Slack, um rascunho, Arquivos ou a fototeca.

Os arquivos voltam nomeados pelo título e pelo instante em que foram feitos, até o milissegundo, então nada do que você exporta sobrescreve outra coisa.

O que uma captura ainda não consegue fazer

Vale dizer sem rodeios, porque é verdade para todos os métodos aqui: uma imagem não pode ser copiada, pesquisada nem lida por um leitor de tela. Quando o código é para ser usado, e não só olhado, publique um link para o fonte ao lado da imagem.

Isso não é um argumento contra imagens de código. É um argumento para elas não serem a única cópia.

Uma compra, os dois aparelhos

O Codeshot é o mesmo app no Mac e no iPhone, comprado uma vez. Seus temas e ajustes de exportação são seus nos dois.

Se você trabalha mais no Mac, o fluxo completo no computador aprofunda enquadramento e escala de exportação. E se preferir pesar antes as opções gratuitas, Apps de captura de código para iPhone mostra o que mais existe.