Tecnologia

Windows, Mac ou Linux: onde o jsonW roda

O jsonW tem binários para macOS arm64, Linux x86_64, Linux ARM64 e Windows x86_64. Os conectores wcon e wremoto saem só para Mac e Linux.

Por Equipe Wortic 7 min de leitura

O jsonW roda no macOS arm64, no Linux x86_64, no Linux ARM64 e no Windows x86_64. Os binários do repositório ficam na pasta bin/, com uma subpasta para cada plataforma. Os conectores de banco de dados, wcon e wremoto, saem só para macOS e Linux, e no Windows rodam pelo WSL.

Este guia mostra o que cada plataforma recebe, o que muda no Windows, quais servidores web aceitam o jsonW e onde ficam os binários. A pasta com os binários está no repositório, na pasta bin.

Quais plataformas o jsonW cobre?

O README lista quatro alvos: macOS arm64, Linux x86_64, Windows x86_64 e Linux ARM64. As subpastas de bin/ têm esses nomes: macos-arm64, linux-x86_64, linux-arm64 e windows-x86_64. Cada uma traz as ferramentas que a plataforma recebe.

Quais ferramentas saem em cada plataforma?

Pelo README, as ferramentas wjsw, wjsw-cgi e libjsonw saem para macOS arm64, Linux x86_64 e Windows x86_64. No Linux ARM64, o README diz que saem wjsw, wjsw-cgi e libjsonw. A libjsonw sai estática e dinâmica, em todas as plataformas que a recebem.

Os conectores wcon e wremoto saem só para macOS arm64 e Linux x86_64. O README diz que eles são programas independentes, que usam uma biblioteca do sistema: o wcon precisa do libsqlite3, e o wremoto precisa do libcurl. No Debian e no Ubuntu, o README dá o comando de instalação dessas bibliotecas.

O que muda no Windows?

No Windows, o README diz que os conectores wcon e wremoto devem rodar pelo WSL, o Subsistema Windows para Linux. Já o wjsw e o libjsonw têm binários próprios para Windows x86_64, na pasta bin/windows-x86_64. O addon Node, segundo o README, sai só para macOS e Linux.

Essa diferença importa para equipes que usam Windows no servidor. Antes de escolher a arquitetura, separe o que precisa do conector de banco, que pede WSL, do que só precisa do wjsw.

Quais servidores web aceitam o jsonW?

O README diz que o wjsw-cgi roda em Apache, nginx com fcgiwrap, LiteSpeed, Caddy e IIS. A pasta servidores-web do repositório traz as configurações prontas. O mesmo README avisa que todo pedido de arquivo .jsw passa pelo wjsw-cgi, que aplica a visão por permissão antes de entregar o dado.

Qual versão de Linux eu preciso?

O README diz que os binários Linux pedem glibc 2.34 ou mais novo, o que cobre Ubuntu 22.04 ou mais novo, Debian 12 ou mais novo e RHEL 9 ou mais novo. Confirme a versão da sua distribuição antes de copiar os binários para o servidor.

Como escolher a pasta certa de bin/, passo a passo?

Primeiro, descubra a plataforma da máquina pelo mesmo critério que o SDK de Ruby usa. O código monta o nome com o sistema e com o processador: no macOS a pasta começa por macos, no Windows por windows, e nos demais casos por linux. O processador passa por uma tabela que converte aarch64 e arm64e para arm64, e amd64 e x64 para x86_64. Assim, um Mac com processador Apple Silicon cai na pasta macos-arm64, e um Linux de 64 bits cai em linux-x86_64. Segundo, copie a libjsonw da pasta correspondente para o lugar que o seu SDK procura. Terceiro, se a biblioteca não for encontrada, o SDK de Ruby para com uma mensagem que traz o nome da plataforma, na forma libjsonw nao encontrada para e o nome, seguida da instrução de apontar JSONW_LIB ou de copiar a biblioteca para a pasta sdk.

Quais bibliotecas cada sistema procura?

O SDK de Ruby procura libjsonw.dylib no macOS e libjsonw.so no Linux. No Windows, ele procura libjsonw.dll ou jsonw.dll. Esses nomes estão no código, e o README raiz diz que o pacote traz libjsonw estática e dinâmica para as plataformas que a recebem. Se você usa outro SDK, confira o nome da biblioteca no README da pasta dele.

Como fica o passo a passo no Windows?

No Windows x86_64, o README indica o wjsw e a libjsonw na pasta bin/windows-x86_64. Os conectores wcon e wremoto não saem nativos para Windows, e o README manda rodá-los pelo WSL. Por isso, o caminho prático é usar o wjsw nativo para ver e conferir arquivos, e levar os conectores de banco para um Linux ou para o WSL. O IIS aparece entre os servidores web que o wjsw-cgi atende, então um servidor Windows pode servir arquivos .jsw pelo mesmo programa de CGI.

Quais erros aparecem quando a biblioteca não é encontrada?

Quando o SDK de Ruby não acha a libjsonw, a mensagem é a que o código define, com o nome da plataforma no meio. A saída traz uma instrução de correção: apontar JSONW_LIB para o caminho inteiro da biblioteca, ou copiar a biblioteca para a pasta sdk. Esse erro costuma indicar uma pasta de plataforma errada. Confira o nome da pasta contra a lista de bin/ antes de mexer em outra coisa.

O que a prova cobre e o que não cobre?

O README diz que a versão 1.4.1 foi medida no macOS arm64, com 37 verificações, e que a suíte completa também passa com AddressSanitizer e UBSan no Linux. O prova.sh do SDK usa a pasta bin da plataforma da máquina. Esses são os dados que o README registra. Ele não diz que a mesma suíte roda no Linux ARM64 nem no Windows x86_64. O que está registrado é o macOS arm64 e o Linux com sanitizers. Para as outras plataformas, a conta honesta é testar na sua máquina antes de copiar os binários para produção.

Onde a Wortic entra?

O jsonW é público e grátis para usar dentro do seu produto, segundo o README, sob a Sustainable Use License, que proíbe revender o jsonW como serviço. A página para desenvolvedores da Wortic descreve as APIs abertas de CNPJ e CEP e lista os SDKs que a Wortic cita.

Se a sua equipe quer um assistente de IA que consulte o sistema da Wortic, o conector da Wortic para o Claude e o ChatGPT é outro produto, separado dos binários. Para comparar os planos, veja a página de planos. O código e o README do jsonW estão no repositório público do jsonW.

Perguntas frequentes

O jsonW roda em Linux ARM64?

Sim, para as ferramentas wjsw, wjsw-cgi e libjsonw, segundo o README. Os conectores wcon e wremoto não saem para Linux ARM64.

Preciso de WSL para usar o jsonW no Windows?

Só para os conectores wcon e wremoto, que o README indica rodar pelo WSL. O wjsw e a libjsonw têm binários para Windows x86_64.

Qual versão de glibc o Linux precisa?

O README diz que os binários Linux pedem glibc 2.34 ou mais novo, o que cobre Ubuntu 22.04 ou mais novo, Debian 12 ou mais novo e RHEL 9 ou mais novo.

Fontes

Conheça: jsonW (json Wondrous): o formato de dados da Wortic.

Quer isso funcionando na sua empresa?

Um consultor da Wortic olha o seu caso e mostra o caminho, sem compromisso.

Falar com um consultor

Equipe editorial

Equipe editorial da Wortic especializada em automacao, IA, ERP, CRM e crescimento operacional.

  • Automacao com IA
  • Gestao empresarial
  • CRM
  • ERP
  • Marketing digital

Isso funcionando no seu negócio.

Um consultor mostra o sistema do seu ramo, com a IA dentro.