Compile project
Compile project {( {arquivoProjeto}{;}{opções} )} -> Resultado
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| arquivoProjeto | 4D.File | → | Arquivo .4DProject a compilar |
| opções | Object | → | Objeto que especifica opções de compilação |
| Resultado | Object | ← | Objeto que contém informação do status da compilação |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
Compile project permite compialr o projeto do host atual ou o projeto especificado no parâmetro projectFile. Para saber mais sobre compilação, veja a página de compilação em developer.4d.com.
Como padrão, o comando usa as opções de compilador definidas nas Configurações de Estrutura. Pode ignorá-las usando o parâmetro options. As sintaxes abaixo são permitidas:
- Compile project (): compila o projeto aberto usando as opções definidas na Configurações de Estrutura
- Compile project (options): compila o projeto aberto. As options definidas ignoram as Configurações de Estrutura
- Compile project (projectFile): compila projectFile 4DProject usando as opções definidas nas Configurações de Estrutura
- Compile project (projectFile; options): compila o projectFile 4DProject e as opções definidas ignoram as Configurações de Estrutura
Nota: Bancos de dados binários não podem ser compilados usando esse comando.
Diferente da janela do Compilador, esse comando precisa que determine explicitamente os componentes a compilar. Quando compilar um projeto com Compile project , precisa declarar seus componentes usando a propriedade componentes do parâmetro options. Lembre que os componentes já devem estar compilados (componentes binários são permitidos).
O modo resultante compilado será armazenado na pasta DerivedData ou Libraries do projeto, dependendo da propriedade targets/alvos do parâmetro options. Se quiser criar arquivos .4dz, ainda precisa zipar/comprimir manualmente o projeto compilado ou usa a funcionalidade build application.
Se passar uma coleção vazia em targets, Compile project executa uma checagem de sintaxe sem compilar.
Erros de compilação, se houverem, serão retornadas como objetos na coleção erros.
Nota: não se pode chamar esse comando quando outra compilação estiver rodando (por exemplo uma compilação lançada na janela Compilation).
Parâmetro options
O parâmetro options é um objeto. As opções de compilação disponíveis estão abaixo:
| Propriedade | Tipo | Descrição |
|---|---|---|
| components | Colección | Coleção de objetos 4D.File para componentes dependentes (devem estar compilados) |
| targets | collection of strings | Valores possíveis: "x86_64_generic", "arm64_macOS_lib". Passe uma coleção vazia para executar apenas checagem de sintaxe |
| typeInference | String | "all": Digite todas as variáveis, "locals": Processo e interprocesso são digitadas, "none": Todas as variáveis são digitadas |
| defaultTypeForNumerics | Integer | Valor possível: Is real ou Is longint |
| defaultTypeForButtons | Integer | Valor possível: Is real ou Is longint |
| generateSymbols | Boolean | True para gerar informação de simbolo no objeto retornado .symbol[#tab/ |
| generateSyntaxFile | Boolean | True para gerar um arquivo de sintaxe para completar código na pasta \Resources\en.lproj do projeto |
| generateTypingMethods | String | Reseta ou anexa para gerar métodos digitação. Se valor for "append"/anexar, declarações de variável existentes ão são modificadas (comportamento janela de compilador) |
| plugins | Objeto 4D.Folder | Pasta Plug-ins a ser usada em vez da pasta Plugins do projeto atual. Essa propriedade só está disponível com a sintaxe projectFile. |
| targets | Coleção de strings | Valores possíveis: "x86_64_generic", "arm64_macOS_lib". Passe uma coleção vazia para executar apenas checagem de sintaxe |
| typeInference | String | "all": Digita todas as variáveis, "locals": Processo e interprocesso são digitadas, "none": Todas as variáveis são digitadas |
Resultado da função
O objeto retornado por Compile project tem três propriedades:
| Propriedade | Tipo | Descrição |
|---|---|---|
| success | Boolean | True se a ação salvar tiver sucesso. Senão False. |
| Disponível só em caso de erro ou aviso: | ||
| errors | Collection of objects | coleção de objetos descrevendo avisos ou erros de compilação |
| isError | Boolean | Erro se True, senão um aviso |
| message | String | Mensagem de erro |
| code | Object | Objeto code |
| line | Number | Número de linha de erro no código. Para métodos de classe, número de linha na função |
| lineInFile | Number | Número linha no arquivo (diferente de métodos classe "line" , e leva em consideração os %attributes linha prefixo) |
| Disponível só se a opção generateSymbols for estabelecida como True: | ||
| symbols | Object | |
| interprocessVariables | Object | Lista de todas as variáveis interprocesso |
| variables | Collection | Coleção de Objetos variable |
| size | Number | |
| processVariables | Object | Lista de todos as variáveis processo |
| variables | Collection | Coleção de Objetos variable |
| size | Number | |
| localVariables | Coleção de objetos | Lista de variáveis locais por método |
| code | Object | Objeto code |
| variables | Collection | Coleção de Objetos variable |
| methods | Coleção de objetos | Lista de métodos |
| code | Object | Objeto code |
| callCount | Number | Número de vezes que esse método foi chamado |
| params | Collection | Coleção de tipos parâmetros (Códigos númericos de tipo valor) |
| threadSafe | Boolean | Indica se este método é thread safe |
Para saber mais, veja Compilation tools.
Objetos variable
Tanto interprocessVariables.variables quanto processVariables.variables contém objetos com as estruturas abaixo:
| Propriedade | Tipo | Descrição |
|---|---|---|
| name | String | Nome da variável |
| type | number | Ttipo da variável (como comando tipo Value) |
| arrayDimension | number | Apenas para arrays: 1 para arrays dimensão mono, 2 para arrays duas dimensões |
| code | Object | Para variáveis processos e interprocessos: descripitor de onde a variável foi definida |
Objeto code
a propriedade code em methods[ ].code e errors[ ].code é um objeto com as propriedades abaixo:
| Propriedade | Tipo | Descrição |
|---|---|---|
| type | String | "projectMethod", "formObjectMethod", "formmethod","databaseMethod", "triggerMethod", "executeOnServer" (when calling a project method with the Executar no atributo servidor.), "executeFormula" (when executing a formula via PROCESS 4D TAGS or the evaluation of a formula in a 4D Write Pro document.), "class", "classFunction" |
| path | String | Rota método (mesmo formato que METHOD OPEN PATH) |
| file | 4D.File | Arquivo de método |
| Retornado dependendo do valor da propriedade tipo: | ||
| methodName | String | método projeto |
| table | Number | Número da tabela (retornado para um trigger, um método formulário tabela ou método objeto formulário tabela) |
| formName | String | nome formulário (retornado para um método formulário) |
| objectName | String | Nome objeto formulário (retornado para um método objeto) |
| className | String | Class name |
| functionName | String | nome função Class |
| databaseMethod | Number | índice método de Database |
Advertência
Para fazer uma checagem de sintaxe apenas, passe uma coleção vazia aos parâmetros alvos:
var $options;$status : Object
$options:=New object
$options.targets:=New collection //Coleção vazia para checar sintaxe
$status:=Compile project($options)
Compilar o projeto atual usando as opções compilador da Configuração Estrutura apenas:
var $status : Object
$status:=Compile project
Em um Silicon Mac, compile o projeto atual para apenas ARM:
var $options;$status : Object
$options:=New object
$options.targets:=New collection("arm64_macOS_lib")
$status:=Compile project($options)
Compilar um projeto outro que o projeto atual :
var $status : Object
var $projectFile: 4D.File
$projectFile:=Folder(fk documents folder).file("Databases/myApp/Project/myApp.4DProject")
$status:=Compile project($projectFile)
Compile um projeto e declare seus componentes:
var $options;$status : Object
var $component : 4D.File
$options:=New object
$component:=Folder(fk documents folder).file("Components/myComponent.4dz")
$options.components:=New collection($component)
$status:=Compile project($options)