Instalar o 8th localmente

Instalar o 8th

O 8th é distribuído num ficheiro ZIP que inclui tudo, com versões do 8th para todas as plataformas suportadas pela versão que descarregaste. As tuas versões do 8th são licenciadas especificamente para ti e não podem ser partilhadas.

Obter o ficheiro zip

Começando na página Obter o 8th,

• preenche o formulário com o teu nome e o teu email e seleciona a versão Free. Tens de aceitar a licença do 8th.
• A 8th-dev vai enviar-te um email para confirmar o teu registo. Clica na ligação desse email de registo.
• A 8th-dev vai compor um ficheiro zip único para ti e enviar-te um email sobre isso. Procura a ligação "download here" nesse email.

Instalar

Para usares o 8th, tens de descomprimir o ficheiro zip para uma pasta a que tenhas acesso.

O zip inclui várias pastas:

Utilizadores Pro+: repara que as chaves de encriptação no id.blob são únicas para cada versão específica do 8th que descarregares, e são importantes para construir aplicações encriptadas prontas a publicar. Se moveres o 8th para fora do seu pacote de distribuição e ele não conseguir encontrar o id.blob , então, se fizeres 8th -v , ele indica custid: id.blob? como lembrete de que não consegue encontrar a informação de identificação.

Independentemente da plataforma em que desenvolvas, podes produzir aplicações para qualquer plataforma suportada pelo 8th.

Depois de descomprimires o ficheiro zip, podes executar o 8th diretamente. Por exemplo, se o instalaste em /opt/8th no Linux de 64 bits, deves conseguir escrever /opt/8th/bin/lin64/8th com os parâmetros que quiseres, e deve funcionar corretamente. Faz algo semelhante no macOS ou no Windows.

Se adicionares a pasta do binário do 8th à variável de ambiente PATH do teu sistema, passas a poder escrever simplesmente 8th em vez de escrever o caminho completo até ele.

Usar o 8th

O próprio 8th é um programa de linha de comandos: não foi pensado para ser iniciado com um clique num ícone do ambiente de trabalho. Podes criar programas com interface gráfica normais que podem ser iniciados dessa forma, mas o próprio compilador do 8th é um programa de CLI (interface de linha de comandos).

Se estiveres a usar o Windows e uma shell MSys ou Cygwin, podes também precisar do programa winpty, disponível gratuitamente, para que os teus programas em modo consola funcionem corretamente. As versões recentes do Windows 10 parecem não precisar disso.

Se estiveres a usar o macOS, lê este tópico do fórum do 8th.

A linha de comandos do 8th é assim:

8th [options] [[-f] file...] [-e 'code'...]

Em que a opção [-f] file significa "interpretar o conteúdo do ficheiro", e -e code significa "interpretar esse código 8th específico". Ambas as opções podem ser indicadas mais do que uma vez na linha de comandos, e o efeito é cumulativo. Por outras palavras:

8th -f first.8th -f second.8th

vai interpretar o conteúdo do ficheiro first.8th e depois interpretar o conteúdo do ficheiro second.8th . Nota que, se quiseres executar apenas um ficheiro 8th, não precisas de escrever 8th -f first.8th , podes simplesmente escrever 8th first.8th .

Aqui estão todas as opções de CLI que o 8th compreende:

Em geral, não deves precisar de usar as opções -k , -r ou -s ; são fornecidas caso as consideres úteis, por exemplo se 128K itens na pilha ao mesmo tempo for demasiado pouco (sinceramente, se for esse o caso, deves mudar o teu algoritmo...).

Se deres por ti a usar frequentemente opções de linha de comandos, podes simplesmente usar um "script de shell" (no macOS ou no Linux) ou um "ficheiro batch" (no Windows; também chamado "ficheiro de comandos") para iniciar o 8th com as opções que preferires.

Também podes criar um ficheiro de código-fonte 8th na pasta app:datadir , com o nome settings.8th . Se estiver presente, o REPL do 8th carrega-o no arranque e mostra uma mensagem nesse sentido. Por razões de segurança, esse ficheiro não é procurado nem carregado numa aplicação empacotada.

Para sair do 8th, faz uma das seguintes coisas:

• Escreve bye e prime ENTER . Isso diz ao 8th para sair normalmente
• Escreve 1 die e prime ENTER . Isso diz ao 8th para sair de forma anormal e devolver o código de estado 1 ao sistema operativo
• Prime a tecla Ctrl+C duas vezes em rápida sucessão, ou Ctrl+D uma vez. Qualquer uma delas diz ao 8th para sair imediatamente
• Numa aplicação em execução, invocar throw provoca uma exceção. Se estiveres a correr a partir da consola do 8th, na maioria dos casos voltas para lá; se estiveres a correr um ficheiro ou uma aplicação empacotada, é mostrada uma mensagem e a aplicação é terminada.

Executar programas 8th

O 8th pode executar os teus programas de várias formas:

Utilizadores Pro+: podem criar aplicações encriptadas para ajudar a dissuadir hackers e outros intervenientes mal-intencionados

Nos dois últimos cenários, o teu código tem de estar em ficheiros de texto simples (por exemplo, não num formato de processamento de texto). Quaisquer ficheiros de apoio devem ser colocados na mesma pasta do teu código, ou numa subpasta dela. Podes aceder a esses outros ficheiros no 8th invocando app:asset .

Uma "app" é um programa autónomo que funciona por si só, como qualquer outro programa da plataforma de destino, e não precisa de ser executado pelo 8th através da linha de comandos. O conteúdo pode ser encriptado para ajudar a dissuadir hackers, como referido acima. Os detalhes sobre como produzir aplicações autónomas encontram-se na secção sobre a utilização da ferramenta de build.

Dica: se estiveres a correr em macOS, Linux ou sistemas RPI, podes fazer com que o teu script funcione como um comando normal do sistema:

• Tornar o ficheiro executável: chmod +x scriptname
• Tornar a primeira linha do teu código: #! /usr/bin/env 8th
• Garantir que um executável relevante do 8th está no teu PATH

Isto também funciona com appdata empacotado, por isso, se usaste bin/build para criar um executável, podes usar o appdata que ele criou da mesma forma, fazendo:

cat - path/to/appdata > newappdata
#! /usr/bin/env 8th<ENTER><CTRL+D>
chmod +x newappdata