Interface de linha de comando
You can use the macOS Terminal or the Windows console to drive your 4D applications (4D and 4D Server) using command lines. Mais especificamente, essa funcionalidade permite que:
- lance um banco de dados remotamente, que pode ser útil especialmente para administrar servidores Web.
- roda automaticamente testes para suas aplicações.
Informação básica
Pode executar linhas de comando para aplicações 4D usando o terminal macOS ou o console Windows.
- Em macOS, precisa usar o comando
open
. - Em Windows pode passar os argumentos diretamente.
Em macOS pode passar os argumentos diretamente indo à pasta onde está a aplicação dentro do pacote (rota Contents/MacOS) que permite dirigir o stream stderr. Por exemplo se o pacote 4D estiver na pasta
MyFolder
, deve escrever a linha de comando abaixo:/MyFolder/4D.app/Contents/MacOS/4D
. Entretanto, recomandos usar o comandoopen
sempre que não precisar acessar o stream stderr.
Lançar uma aplicação 4D
Here is a description of command lines and the arguments supported to launch 4D applications.
Sintaxe:
<applicationPath> [--version] [--help] [--project] [<projectPath | packagePath | 4dlinkPath> [--data <dataPath>]]
[--opening-mode interpreted | compiled] [--create-data] [--user-param <user string>] [--headless] [--dataless]
[--webadmin-settings-file] [--webadmin-access-key] [--webadmin-auto-start] [--webadmin-store-settings]
Argumento | Valor | Descrição |
---|---|---|
applicationPath | Caminho do 4D, 4D Server ou aplicação fundida | Lance a aplicação. Idêntico ao duplo clique na aplicação 4D. When called without structure file argument, the application is executed and the 'select database' dialog box appears. |
--version | Exibe a versão da aplicação e termina | |
--help | Exibe ajuda e sai. Outros argumentos: -?, -h | |
--project | projectPath | packagePath | 4dlinkPath | Arquivo de projeto para abrir com o arquivo de dados atual. Não aparece nenhuma caixa de diálogo. |
--data | dataPath | Arquivo de dados a abrir com o arquivo de projeto designado. Se não for especificado, 4D usa o último ficheiro de dados aberto. |
--opening-mode | interpreted | compiled | Pede para o banco de dados abrir em modo interpretado ou compilado. Nenhum erro é gerado se o modo pedido estiver indisponível. |
--create-data | Cria automaticamente um novo arquivo de dados se nenhum arquivo válido for encontrado. Não aparece nenhuma caixa de diálogo. 4D usa o nome de arquivo passado no argumento "--data" se houver (gera um erro se um arquivo com o mesmo nome já existir). | |
--user-param | String usuário personalizada | A string that will be available within the 4D application through the Get database parameter command (the string must not start with a "-" character, which is reserved). |
--headless | Lança 4D, Servidor 4D, ou a aplicação fusionada, sem uma interface (modo headless). Nesse modo: Para questões de manutenção é possível enviar qualquer texto para streams normais de output usando o comando LOG EVENT. Note que aplicações headless 4D só podem ser fechadas com uma chamada a QUIT 4D ou usando o gerente de tarefas do OS. | |
--dataless | Lança 4D, 4D Server ou aplicação fundida em modo dataless. Lança 4D, servidor 4D ou uma aplicação fusionada em modo Dataless. Nesse modo: .4DLink , ou se usar os comandos CREATE DATA FILE e OPEN DATA FILE CREATE RECORD gera a mensagem “nenhuma tabela está disponível para aplicar este comando”.Nota: .4DLink , modo dataless só se aplica aos bancos especificados no arquivo .4DLink . For more information on .4DLink files, see Project opening shortcuts. | |
--webadmin-settings-file | Rota do arquivo | Path of the custom WebAdmin .4DSettings file for the WebAdmin web server |
--webadmin-access-key | String | Chave de acesso para o servidor web WebAdmin |
--webadmin-auto-start | Parâmetros | Status of the automatic startup for the WebAdmin web server |
--webadmin-store-settings | Armazena a chave de acesso e inicia automaticamente os parâmetros nas configurações de arquivo utilizadas (ou seja, o arquivo padrão WebAdmin.4DSettings ou um arquivo personalizado designado pelo parâmetro --webadmin-settings-path ). Use the --webadmin-store-settings argument to save these settings if necessary |
(*) Some dialogs are displayed before the database is opened, so that it's impossible to write into the
Diagnostic log file (licence alert, conversion dialog, database selection, data file selection). Nesses casos, uma mensagem de erro é criada tanto no stream stderr e no arquivo de eventos do sistema, e então a aplicação fecha.
Exemplos
A pasta atual do usuário é alcançada usando o comando "~ " em macOS e o comando "%HOMEPATH%" em Windows.
Lance uma aplicação 4D armazenada no desktop:
- macOS:
open ~/Desktop/4D.app
open "~/Desktop/4D Server.app"
- Windows:
%HOMEPATH%\Desktop\4D\4D.exe
%HOMEPATH%\Desktop\"4D Server.exe"
Abrir um ficheiro de pacote em macOS:
--args ~/Documents/myDB.4dbase
Abrir um ficheiro de projecto:
- macOS:
--args ~/Documentos/myProj/Projecto/myProj.4DProject
- Windows:
%HOMEPATH%\Documents\myProj\Project\myProj.4DProject
Abrir um ficheiro de projecto e um ficheiro de dados:
- macOS:
--args --project ~/Documents/myProj/Project/myProj.4DProject --data ~/Documents/data/myData.4DD
- Windows:
--project %HOMEPATH%\Documents\myProj\Project\myProj.4DProject --data %HOMEPATH%\Documents\data\myData.4DD
ou:
/project %HOMEPATH%\Documents\myProj\Project\myProj.4DProject /data %HOMEPATH%\Documents\data\myData.4DD
Abrir um ficheiro .4DLink:
- macOS:
~/Desktop/MyDatabase.4DLink
- Windows:
%HOMEPATH%\Desktop\MyDatabase.4DLink
Abrir em modo compilado e criar um arquivo de dados se não disponível:
- macOS:
~/Documents/myBase.4dbase --args --opening-mode compiled --create-data true
- Windows:
%HOMEPATH%\Documents\myBase.4dbase\myDB.4db --opening-mode compiled --create-data true
Abrir um ficheiro projeto e um arquivo de dados e passar uma “string” como parâmetro do usuário:
- macOS:
--args --project ~/Documents/myProj/Project/myProj.4DProject --data ~/Documents/data/myData.4DD --user-param "Hello world"
- Windows:
--project %HOMEPATH%\Documents\myProj\Project\myProj.4DProject --data %HOMEPATH%\Documents\data\myData.4DD --user-param "Hello world"
Aberto sem interface (modo headless):
- macOS:
--args --project ~/Documents/myProj/Project/myProj.4DProject --data ~/Documents/data/myData.4DD --headless
- Windows:
--project %HOMEPATH%\Documents\myProj\Project\myProj.4DProject --data %HOMEPATH%\Documents\data\myData.4DD --headless