Guia Completo: Como Dominar o CodeEditSourceEditor - Tutorial do Editor de Código em Swift

O CodeEditSourceEditor é um componente de editor de código desenvolvido em Swift, com suporte robusto fornecido pelo tree-sitter. Este tutorial ajudará você a dominar rapidamente este editor, explorando suas principais funcionalidades e técnicas avançadas.

Introdução ao CodeEditSourceEditor

O CodeEditSourceEditor é um componente de editor de código inspirado no Xcode, projetado especificamente para o projeto CodeEdit. Ele oferece várias funcionalidades modernas como destaque sintático, sugestões de código, busca e substituição eficientes, comparação de texto, realce de linhas e mini mapa, proporcionando uma experiência completa de edição para desenvolvedores Swift.

Principais Recursos

1. Destaque Sintático Avançado Implementado com base no tree-sitter, esse recurso oferece suporte a múltiplas linguagens de programação, tornadno a estrutura do código clara e legível. A implementação pode ser encontrada no arquivo TreeSitterClient.swift.
2. Sugestão Inteligente de Código Oferece recomendações precisas de código com base no contexto atual. O núcleo da implementação está na pasta CodeSuggestion.
3. Busca e Substituição Eficiente Fornece vários modos de busca e opções de substituição para localizar e modificar rapidamente trechos de código. Mais detalhes estão disponíveis no módulo Find.
4. Função de Dobramento de Código Permite o colapso de blocos de código com base na indentação, melhorando a clareza de estruturas complexas. O código relevante está na pasta LineFolding.
5. Navegação com Mini Mapa O mini mapa à direita fornece uma visão global do código, facilitando a navegação rápida. O código relacionado está na pasta Minimap.

Começando Rapidamente

Preparação do Ambiente

1. Clone o repositório:

git clone https://gitcode.com/gh_mirrors/co/CodeEditSourceEditor

2. Abra o projeto: O projeto utiliza o Swift Package Manager para gerenciar dependências e pode ser aberto diretamente pelo arquivo Package.swift no Xcode.

Exemplo de Integração com SwiftUI

O CodeEditSourceEditor inclui componentes simples do SwiftUI para facilitar a integração em seus projetos:

import CodeEditSourceEditor

struct ContentView: View {
    @State private var codigo = "print(\"Olá, CodeEdit!\")"
    @State private var configuracao = SourceEditorConfiguration()
    
    var body: some View {
        SourceEditor(
            text: $codigo,
            configuration: configuracao
        )
        .frame(minWidth: 800, minHeight: 600)
    }
}

Personalização da Aparência do Editor

Através da classe SourceEditorConfiguration, é possível personalizar facilmente a aparência e comportamento do editor:

// Configurando o tema do editor
configuracao.tema = EditorTheme.defaultDark

// Exibindo números de linha
configuracao.mostrarNumerosDeLinha = true

// Definindo o tamanho da fonte
configuracao.tamanhoDaFonte = 14

// Ativando o mini mapa
configuracao.mostrarMiniMapa = true

O código relacionado aos temas está localizado na pasta Sources/CodeEditSourceEditor/Theme/, onde você pode criar temas personalizados conforme necessário.

Linguagens de Programação Suportadas

O CodeEditSourceEditor utiliza o projeto CodeEditLanguages para fornecer suporte sintático, abrangenod várias linguagens populares, incluindo:

• Swift
• JavaScript
• Python
• Java
• C/C++
• HTML/CSS
• E mais...

Para obter a lista completa de linguagans suportadas, consulte o documento CodeEditLanguages#10.

Explorando Funcionalidades Avançadas

1. Edição com Múltiplos Cursosres: Permite editar várias posições simultaneamente, aumentando significativamente a produtividade.
2. Correspondência de Parênteses: Realça automaticamente parênteses correspondentes, reduzindo erros de sintaxe.
3. Formatação Automática de Código: Suporta recuo automático e formatação de código.
4. Controle de Linha e Dobramento: Implementado no arquivo GutterView.swift.