crux

Crux ·

Desenvolvimento de aplicativos de plataforma cruzada em ferrugem

• Core Shared for Behavior - Crux ajuda você a compartilhar a lógica e o comportamento de negócios do seu aplicativo em Mobile (iOS/Android) e Web - como um único núcleo reutilizável construído com ferrugem.
• Shell fino para interface do usuário - Crux reconhece que as melhores experiências são construídas com estruturas declarativas modernas, como Swiftui, Jetpack, compõem, React/Vue ou uma estrutura baseada em WebAssembly (como teixo) - no entanto, pretende manter essa camada da interface do usuário o mais fina possível, com todos os outros trabalhos realizados pelo núcleo compartilhado.
• Geração de tipos - A interface com o núcleo possui verificação de tipo estático entre os idiomas - os tipos e o código de serialização são gerados para Swift, Kotlin e TypeScript. As conchas de ferrugem podem importar o núcleo diretamente.
• Recursos - os recursos expressam a intenção de efeitos colaterais, como chamar uma API. Como todos os efeitos colaterais (incluindo a interface do usuário) são realizados pelo shell, o núcleo se torna trivial para testar de maneira abrangente - as suítes de teste são executadas em milissegundos (não em minutos ou horas).

Começando

Aprenda a usar o Crux em seu projeto.

Siga o ReadMe no repositório do projeto no GitHub.

Leia a documentação da API

Assista à conversa introdutória na recente conferência Rust Nation 2023 em Londres.

Você também pode participar da conversa amigável em nosso canal Zulip.

Observe que o Crux é experimental e atualmente em desenvolvimento ativo (provavelmente ainda não está pronto para uso em aplicativos de produção). No entanto, a filial principal deve estar sempre funcionando bem, e tentaremos manter os exemplos e documentação atualizados à medida que avançamos. Acreditamos que a API já se estabeleceu, então faça uma peça! :-)

Visão geral arquitetônica

O conceito arquitetônico fundamental é a separação estrita de tarefas computacionais puras de tarefas que causam efeitos colaterais. Isso é semelhante à maneira como o Elm funciona.

Núcleo sem efeito colateral

No diagrama acima, o "núcleo" interno é compilado e vinculado ao "shell" externo em cada plataforma como uma biblioteca:

• No iOS como uma biblioteca estática nativa
• No Android como uma biblioteca dinâmica usando o acesso nativo de Java
• Em um navegador como um módulo WebAssembly

De fato, como o WebAssembly (WASM) é um dos alvos de compilação, o núcleo deve permanecer livre de efeito colateral, devido à natureza da caixa de areia do ambiente de tempo de execução do WASM.

Como tal, o núcleo é completamente isolado e seguro contra ataques de cadeia de suprimentos de software, pois não tem acesso a nenhuma API externa. Tudo o que pode fazer é realizar cálculos puros e manter o estado interno.

Após a arquitetura do ELM, o núcleo define os principais tipos de componentes dentro do aplicativo:

• Event - um enum descrevendo os eventos que o núcleo pode lidar
• Model - descreve o estado interno do aplicativo
• ViewModel - representa informações que devem ser exibidas ao usuário

Os dois primeiros estão unidos pela função update , familiarizados da ELM, Redux ou outras arquiteturas de fornecimento de eventos, que atualmente possui esse tipo de assinatura:

 fn update (
    & self ,
    event : Event ,
    model : & mut Model ,
    capabilities : & Capabilities ,
)

O trabalho da função update é processar um Event , atualizar o modelo de acordo e solicitar potencialmente alguns efeitos colaterais usando recursos.

Shell de aplicação

A plataforma de anexo "Shell" nativa é escrita usando o idioma apropriado para a plataforma e atua como o ambiente de tempo de execução no qual todas as tarefas não-puras são executadas. Da perspectiva do núcleo, o shell é a plataforma na qual o núcleo é executado.

Comunicação entre o shell do aplicativo e o núcleo

Seguindo a arquitetura ELM, a interface com o núcleo é baseada em mensagens. Isso significa que o núcleo é incapaz de realizar qualquer outra coisa que não seja cálculos puros. Para executar qualquer tarefa que crie um efeito colateral (como uma chamada HTTP ou geração de números aleatórios), o núcleo deve solicitá-lo do shell.

O núcleo possui um conceito de capacidades-interfaces reutilizáveis ​​para efeitos colaterais comuns-suportando a semântica de fogo e esquecimento/resposta e streaming.

A única capacidade interna é Render . Mas este repositório contém alguns recursos em vários estágios de maturidade, e você pode escrever facilmente o seu, se quiser:

1. Render (peça à interface do usuário para renderizar o ViewModel)-fonte, embutida para crux_core , apenas solicita
2. Http (implementação HTTP completa com base na API de surf) - fonte, caixa, solicitação/resposta
3. KeyValue (API básica de armazenamento de valor-chave)-Fonte, Crate, Solicitação/Resposta
4. Time (obtenha o horário atual, notifique após a duração, notifique no instante) - fonte, caixa, solicitação/resposta
5. Platform (obtenha a plataforma atual) - fonte, caixa, solicitação/resposta
6. SSE (Eventos básicos de envio ao servidor)-Fonte, solicitação/streaming
7. PubSub (sub sub streaming) - fonte, solicitação/resposta/streaming
8. Timer (Timer Iniciar, terminar, cancelar) - Fonte, solicitação/resposta/streaming
9. Delay - parte do tutorial no livro

Red Badger é a consultoria de produtos digitais confiável por chips azuis e marcas globais. Nosso design de produto e pedigree técnico nos permitem criar produtos digitais de alto impacto que os clientes desejam. Utilizamos abordagens modernas de engenharia para oferecer mudanças sustentáveis. E incorporar recursos digitais para impulsionar a inovação contínua.

---

Zulip

O Zulip é um aplicativo de bate-papo em equipe moderno de código aberto projetado para manter conversas ao vivo e assíncronas organizadas.

O Zulip Patrocination Crux fornecendo nosso servidor Zulip - obrigado Zulip!

---