Primeiros passos

Visão Geral

O Spck Editor é uma solução de edição de código móvel com múltiplas variantes projetadas para desenvolvedores.

Versões

Spck Editor (Gratuito)

• Funcionalidade básica de edição de código móvel
• Integração de biblioteca git portátil via isomorphic-git

Spck Editor Lite

Preço: Pagamento único Recursos:

• Snippets Personalizados
• Teclado Preditivo
• Tema Neon Exclusivo

Spck para NodeJS

Plataforma: Exclusivo para Android Recurso Principal: Terminal integrado com suporte NodeJS

Versão para Navegador

• Incorporável em qualquer site
• Interface leve de edição de código

Recursos Principais

• Design mobile-first
• Integração com Git
• Compatibilidade multiplataforma

Uso Recomendado

• Edição de código em movimento
• Modificações rápidas de projetos
• Aprendizado e prototipagem

Terminologia

Termo	Descrição
Menu de Navegação	Refere-se à Primeira Aba no menu lateral em dispositivos móveis, este menu não está disponível na versão para navegador ou no modo Tablet
Menu de Arquivos	Refere-se à aba File no menu lateral ou na barra lateral
Teclado Extra	Em dispositivos móveis existe um teclado adicional com símbolos de codificação comumente usados para inserção rápida
Teclado de Toque	Geralmente isto se refere à linha de teclas contendo as teclas de seta, a tecla tab e mais
Barra de Ação de Toque	Este é o menu flutuante que aparece acima do cursor quando o texto é selecionado em dispositivo móvel/toque
Cursores de Toque	Os cursores em tela que aparecem em dispositivo móvel/toque quando o texto é selecionado ou o cursor está ativo
Modo Tablet	Isto se refere a uma configuração que pode ser ativada em dispositivos de toque maiores como um tablet
Tecla ⌘	Este símbolo no Teclado de Toque é o mesmo que a tecla Ctrl no Windows ou a tecla Command no Mac
Tecla ⌥	Este símbolo no Teclado de Toque é o mesmo que a tecla Alt no Windows ou a tecla Option no Mac

 

 

Atalhos de Teclado

Visão Geral

Desbloqueie uma eficiência ultrarrápida com estes atalhos de teclado úteis! Embora não seja um catálogo completo, estas joias irão potencializar sua produtividade e tornar a navegação um passeio.

Destaques Principais

• Não exaustivo: Uma seleção curada dos atalhos mais práticos
• Propósito: Impulsionar seu fluxo de trabalho com comandos rápidos e intuitivos
• Benefício: Economize tempo e reduza a dependência do mouse

💡 Dica Pro: Memorize estes atalhos e veja sua produtividade decolar! 🌟

Você pode visualizar a lista completa de atalhos indo em Settings > Editor > Keyboard Shortcuts

Usuários premium também podem acessar os Atalhos de Teclado diretamente do Teclado Extra ou usando o atalho ⌘ K

Ative a tecla Ctrl/Command (⌘) e a tecla Alt/Options ativando Settings > Touch > Show ⌘ Key e Settings > Touch > Show ⌥ Key

Editor

Atalho	Ação
⌘ A	Selecionar Tudo
⌘ C	Copiar
⌘ V	Colar
⌘ X	Recortar
⌘ Z	Desfazer
⌘ ⇧ Z	Refazer
⌘ D	Duplicar Linha
⌘ /	Comentar/Descomentar Linha
⌥ F	Formatar Código
⌘ F	Localizar
⌘ G	Localizar Próximo (Funciona com texto selecionado)
⌘ ⇧ G	Localizar Anterior
⌘ L	Ir para a Linha

Ações Rápidas

Atalho	Ação
⌘ ⇧ C	Git Commit
⌘ O	Abrir Arquivos Recentes
⌘ ⇧ P	Iniciar Pré-visualização do Projeto
⌘ P	Alternar Pré-visualização de Arquivo (SVG, Markdown)
⌘ K	Supporter+: Abrir Atalhos

 

 

Configurações de Toque

Teclado Extra

• O Teclado Extra é um teclado de símbolos projetado para Dispositivos de Toque.
• Teclas/Símbolos adicionais podem ser acessados pressionando e mantendo as teclas, o que abre um menu de opções.
• Você pode ativá-lo ou desativá-lo no menu Settings > Touch > Extra Keyboard.

💡 Dica Pro: Veja Edição Avançada para dicas sobre como envolver texto, que é compatível com o Teclado Extra.

Teclado de Toque

• As Teclas de Toque consistem em uma linha de teclas incluindo Teclas de Seta, Tecla Command e outras teclas frequentemente usadas.
• Este recurso está disponível em Dispositivos de Toque.
• Você pode alterná-lo ligado ou desligado na seção Settings > Touch > Touch Keyboard.

💡 Dica Pro: Você pode personalizar teclas individuais neste teclado ajustando as configurações.

Barra de Ação de Toque

• Uma barra de ação aparecerá com opções de Copiar, Recortar e Colar quando o texto for selecionado.
• Este recurso pode ser ativado ou desativado em Settings > Touch > Touch Action Bar.

Cursores de Toque

• Cursores em tela que aparecem quando o texto é selecionado ou o cursor está ativo.
• Este recurso pode ser ativado ou desativado em Settings > Touch > Touch Cursors.

💡 Dica Pro: Não é recomendado desativar este recurso a menos que você tenha um mouse/dispositivo apontador pareado com o dispositivo móvel. Desativar os cursores de toque pode melhorar a visibilidade da tela durante a edição e melhorar a experiência de edição ao usar dispositivos apontadores externos.

Teclas Preditivas

• Teclas Preditivas é um recurso premium que substitui o Teclado Extra padrão.
• Oferece entrada de símbolos com um toque em vez de ter que pressionar e selecionar no Teclado Extra regular
• As teclas são ordenadas pela frequência estatística de símbolos aparecendo em uma posição específica no arquivo.
• Pode ser ativado ou desativado em Settings > Touch > Predictive Keyboard.

💡 Dica Pro: As Teclas Preditivas substituem o Teclado Extra regular que alguns usuários podem preferir. As Teclas Preditivas são uma opção padrão na versão Lite do editor, e podem ser desativadas para recuperar o Teclado Extra regular.

 

 

Navegação de Arquivos

Visão Geral

• Existem múltiplos métodos para navegar entre arquivos
• Você pode navegar pelos arquivos usando Arquivos no menu lateral
• Você pode usar o breadcrumb para navegar pelos arquivos começando pelo diretório do arquivo atual
• Você pode abrir Arquivos Recentes Ctrl-O para pesquisar rapidamente arquivos
• Você pode usar o ícone "Locate" no menu lateral de Arquivos para identificar rapidamente os arquivos atuais
• Os menus laterais de Controle de Origem e Pesquisa também oferecem maneiras únicas de navegar entre arquivos

Gerenciamento de Abas de Arquivos

Comportamento das Abas

• Os arquivos são automaticamente desafixados quando abertos inicialmente
• As abas tornam-se fixadas quando edições são feitas

Opções de Classificação de Abas

Os arquivos podem ser classificados por:

• Ordem alfabética
• Extensão do arquivo
• Caminho do arquivo

Canais de Navegação Alternativos

• Menu de Controle de Origem: Navegar pelos arquivos através do contexto de controle de versão
• Menu de Pesquisa: Encontrar e acessar arquivos com base em critérios de pesquisa

💡 Dica Pro: As Abas de Arquivo podem ser desativadas da visualização em Settings > Appearance > Show File Tabs. Veja Modo Zen para maximizar o espaço de tela em dispositivos menores.

 

 

Edição Avançada

Usando o teclado Preditivo com eficiência

Seleção Básica

• Toque duas vezes para selecionar uma palavra ou bloco de texto

Envolver Texto

Envolva rapidamente o texto selecionado usando pares de parênteses ou aspas:

• Parênteses: ( )
• Colchetes: [ ]
• Chaves: { }
• Aspas simples: ' '
• Aspas duplas: " "

Navegação e Edição

Pesquisa de Texto

• ⌘ G: Localizar próxima instância
• ⌘ ⇧ G: Localizar instância anterior

Indentação

• Selecione um bloco de texto
• Pressione Tab para indentar

 

Múltiplos Cursores

Configuração Rápida

• Ative múltiplos cursores com a tecla Alt/Option! ✨
• Navegue até Settings > Touch > Show ⌥ Key para ativar

Como Usar

1. Selecione as teclas ⌥ e ⌘
2. Clique para colocar os cursores exatamente onde você deseja
3. Edite várias linhas simultaneamente com facilidade! 💻

💡 Dica Pro: Edição multi-cursor = transformação de código ultrarrápida! ⚡️ Também é possível adicionar múltiplos cursores usando o comando da paleta de comandos Add Cursor Above e Add Cursor Below que adicionariam um cursor diretamente acima ou abaixo da posição atual do cursor.

 

 

Limitações do Git

Visão Geral

A integração Git do editor é alimentada pelo isomorphic-git, uma implementação JavaScript pura do Git que roda inteiramente do lado do cliente. Embora isso permita operações Git diretamente no navegador e em dispositivos móveis sem um servidor, vem com várias restrições inerentes a executar o Git em um ambiente JavaScript em sandbox.

Restrições de Memória

• Aplicativos móveis são tipicamente limitados a cerca de 50MB de memória pelo sistema operacional.
• Operações Git em grandes repositórios podem exceder esse orçamento e fazer com que o aplicativo seja encerrado.
• A leitura de grandes arquivos pack (arquivos .pack em .git/objects/pack/) requer o carregamento de porções significativas na memória de uma só vez, o que não é viável em dispositivos com memória restrita.
• Como resultado, clonar ou operar em grandes repositórios pode falhar com erros de falta de memória em dispositivos móveis.

💡 Dica: Para grandes repositórios, use clones rasos (shallow clones) quando possível, ou considere trabalhar com um subconjunto menor do repositório.

Compatibilidade de Symlinks

• Links simbólicos (symlinks) não são suportados nativamente no sandbox do navegador/móvel por razões de segurança.
• O editor usa uma representação de symlink emulado como solução alternativa para que repositórios contendo symlinks ainda possam ser verificados.
• Esta emulação pode ter problemas de compatibilidade com ferramentas que esperam symlinks reais do sistema de arquivos (por exemplo, algumas ferramentas de build, gerenciadores de pacotes ou scripts que resolvem alvos de symlink em tempo de execução).
• Repositórios que dependem fortemente de symlinks podem não se comportar de forma idêntica a um checkout Git nativo.

Usando a CLI como Alternativa

Estas limitações se aplicam apenas ao cliente Git no aplicativo. Elas não afetam o Spck CLI, que usa o binário Git nativo no sistema host:

• Sem teto de memória de 50MB — as operações Git são limitadas apenas pela memória disponível da sua máquina.
• Grandes arquivos pack e grandes repositórios são tratados nativamente.
• Symlinks reais funcionam como esperado, com total compatibilidade com outras ferramentas.
• Todos os recursos Git e comandos plumbing estão disponíveis, não apenas o subconjunto implementado pelo isomorphic-git.

💡 Dica Pro: Se você frequentemente trabalha com grandes repositórios ou projetos que dependem de symlinks, usar o Spck CLI para operações Git (clone, fetch, push) — enquanto ainda edita arquivos no aplicativo móvel — oferece o melhor dos dois mundos.

 

 

🌟 Modo Zen

Visão Geral

O Modo Zen é uma configuração de editor encantadora e maximizadora de espaço projetada para transformar sua experiência de codificação em telas compactas.

O modo Zen consiste em:

• Desativar Show Line Numbers nas configurações
• Desativar Show File Tab
• Desativar Touch Action Bar

Recursos Principais

🧘‍♀️ Espaço de Tela Maximizado

• Adeus aos Números de Linha!
  • Libere o precioso espaço horizontal
  • Evite que o texto pareça apertado
  • Adote a aparência limpa e minimalista

🎨 Interface Simplificada

• Minimização da Barra de Ação
  • Diga adeus às barras de ferramentas desordenadas
  • Utilize métodos de entrada alternativos:
    • Botões de colar/recortar do teclado extra
    • Atalhos de teclado (Ctrl-C/Ctrl-V)

📂 Navegação Simplificada

• Eliminação de Abas de Arquivo
  • Ctrl-O se torna seu novo melhor amigo de navegação
  • Espaço de trabalho mais limpo
  • Troca de contexto mais rápida

💡 Dica Pro: O estilo de codificação de cada um não é o mesmo! Recomendamos experimentar com o Modo Zen para ver se ressoa com seu fluxo de trabalho. Seu ambiente de codificação perfeito está a apenas alguns toques de distância! 🌈✨