@fontdata/ai-harness 4.3.0 → 4.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +2 -2
- package/README.md +80 -2
- package/dist/config/config.js +37 -3
- package/dist/contratos/artefatos.js +13 -5
- package/dist/delphi/command.js +102 -1
- package/dist/delphi/encoding.js +112 -0
- package/dist/init.js +8 -2
- package/dist/install/perfis.js +14 -0
- package/dist/install/plan.js +29 -2
- package/dist/install/settings.js +40 -3
- package/dist/update/update.js +69 -7
- package/package.json +1 -1
- package/templates/catalog.json +3 -0
- package/templates/perfis/delphi/hooks/encoding.mjs +317 -0
- package/templates/perfis/delphi/rules/build-e-verificacao.md +59 -0
- package/templates/perfis/delphi/rules/dados/cnpj-alfanumerico-nao-extrair-so-numeros.md +65 -0
- package/templates/perfis/delphi/rules/dados/data-hora-sql-nunca-round-trip-textual.md +78 -0
- package/templates/perfis/delphi/rules/dados/datestyle-sessao-firedac-postgres.md +60 -0
- package/templates/perfis/delphi/rules/dados/ddl-tabela-nova-exige-trigger-de-log.md +68 -0
- package/templates/perfis/delphi/rules/dados/divisao-e-conversao-numerica.md +53 -0
- package/templates/perfis/delphi/rules/dados/fieldbyname-value-variant-cru-em-aritmetica.md +73 -0
- package/templates/perfis/delphi/rules/dados/filtro-condicional-sql-par-add-parambyname.md +72 -0
- package/templates/perfis/delphi/rules/dados/firedac.md +51 -0
- package/templates/perfis/delphi/rules/dados/macro-firedac-exige-entrada-macrodata.md +96 -0
- package/templates/perfis/delphi/rules/dados/sql-qualificacao-colunas.md +36 -0
- package/templates/perfis/delphi/rules/dados/tmeminifile-getstrings-nao-limpa-destino.md +89 -0
- package/templates/perfis/delphi/rules/encoding-eol.md +130 -0
- package/templates/perfis/delphi/rules/linguagem/dataset-nao-se-le-depois-do-laco-eof.md +56 -0
- package/templates/perfis/delphi/rules/linguagem/existencia-nunca-se-testa-por-campo-formatado.md +60 -0
- package/templates/perfis/delphi/rules/linguagem/float-nunca-comparado-por-igualdade-com-literal.md +55 -0
- package/templates/perfis/delphi/rules/linguagem/literal-enum-de-dfm-exige-unit-no-uses.md +84 -0
- package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md +172 -0
- package/templates/perfis/delphi/rules/linguagem/sem-clipboard-debug.md +43 -0
- package/templates/perfis/delphi/rules/linguagem/validacao-em-onexit-nao-protege-a-gravacao.md +65 -0
- package/templates/perfis/delphi/rules/linguagem/variavel-inline-sai-de-escopo-ao-envolver-bloco.md +69 -0
- package/templates/perfis/delphi/rules/telas/foco-decisao-por-canfocus-nao-tabstop.md +40 -0
- package/templates/perfis/delphi/rules/telas/form-dinamico-liberar-em-toda-saida.md +80 -0
- package/templates/perfis/delphi/rules/telas/heranca-de-form-e-grade-de-selecao.md +58 -0
- package/templates/perfis/delphi/rules/threads-e-timers.md +131 -0
- package/templates/perfis/delphi/rules/try-finally-e-vazamento.md +109 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/SKILL.md +64 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/ATRIBUICAO.md +29 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/acbr-nfce-integracao.md +60 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/build-via-bat-com-log.md +86 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/class-var-vaza-para-campos-de-instancia.md +73 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/componentes-designer-vs-runtime.md +47 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/console-writeln-sem-flush-nao-loga.md +47 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/conversao-numerica-locale.md +47 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/delphi13-breaking-changes.md +41 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/dpr-uses-project-manager.md +62 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-dcc-debuginformation-nao-booleano.md +78 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-projectguid-valido.md +38 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/firedac-registro-drivers.md +94 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/horse-gbswagger-rotas-jwt.md +61 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/msb6003-command-line-too-long.md +52 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/recursos-rcdata.md +67 -0
- package/templates/skills/resolver-bug/SKILL.md +8 -2
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Atribuição
|
|
2
|
+
|
|
3
|
+
Os artigos desta pasta são adaptações (tradução, reorganização e cortes) de artigos do plugin **delphi-dev**,
|
|
4
|
+
disponível em https://github.com/adrianosantostreina/delphi-dev (commit `e5ed42ad1828b3d55ee87e7c6d2dad935391648e`),
|
|
5
|
+
distribuído sob a licença MIT reproduzida abaixo.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
MIT License
|
|
10
|
+
|
|
11
|
+
Copyright (c) 2026 Adriano Santos
|
|
12
|
+
|
|
13
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
14
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
15
|
+
in the Software without restriction, including without limitation the rights
|
|
16
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
17
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
18
|
+
furnished to do so, subject to the following conditions:
|
|
19
|
+
|
|
20
|
+
The above copyright notice and this permission notice shall be included in all
|
|
21
|
+
copies or substantial portions of the Software.
|
|
22
|
+
|
|
23
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
24
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
25
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
26
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
27
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
28
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
29
|
+
SOFTWARE.
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# ACBr NFC-e: integração e armadilhas
|
|
2
|
+
|
|
3
|
+
Observado com ACBr Trunk2 (DCUs pré-compilados) e Delphi 12, usando `TACBrNFe` no modelo 65. Confira na versão do
|
|
4
|
+
ACBr do projeto antes de aplicar: a superfície muda entre revisões.
|
|
5
|
+
|
|
6
|
+
## Sintoma e causa
|
|
7
|
+
|
|
8
|
+
| Sintoma | Causa | Correção |
|
|
9
|
+
|---|---|---|
|
|
10
|
+
| `E2003` em enum de NF-e (`moNFCe`, `ve400`, `fpDinheiro`, `csosn102`) | unit errada no `uses` | enums em `pcnConversaoNFe`; aliases legados (`taHomologacao`, `tnSaida`) em `pcnConversao`; tipos SSL em `ACBrDFeSSL`; componente em `ACBrNFe` |
|
|
11
|
+
| SSL configurado com valor errado ou exceção estranha | cast inteiro (`TSSLLib(4)`) com ordinal do DCU diferente do fonte | usar constantes nomeadas |
|
|
12
|
+
| `Configuracoes.Arquivos.PathPDF` não existe | o caminho do PDF pertence ao DANFE | `DANFE.PathPDF`, conferindo `Assigned(DANFE)` (pode ser nil em servidor) |
|
|
13
|
+
| incompatibilidade de tipo em `IdCSC` | `IdCSC` é `string` | `IdCSC := '000001'` |
|
|
14
|
+
| chave com 47 caracteres | `infNFe.ID` vem com o prefixo `NFe` | `Copy(ID, 4, 44)` |
|
|
15
|
+
| `EInOutError: Unable to create directory` | `ForceDirectories` com caminho relativo chama `ForceDirectories('')` | montar caminho absoluto |
|
|
16
|
+
| `ExtractFilePath(ParamStr(0))` vazio | executável chamado sem caminho completo | cair para `GetCurrentDir` |
|
|
17
|
+
|
|
18
|
+
## Exemplo
|
|
19
|
+
|
|
20
|
+
SSL em simulação (sem transmissão) e em produção:
|
|
21
|
+
|
|
22
|
+
```pascal
|
|
23
|
+
ACBrNFe.Configuracoes.Geral.SSLLib := libNone;
|
|
24
|
+
ACBrNFe.Configuracoes.Geral.SSLCryptLib := cryNone;
|
|
25
|
+
ACBrNFe.Configuracoes.Geral.SSLHttpLib := httpNone;
|
|
26
|
+
ACBrNFe.Configuracoes.Geral.SSLXmlSignLib := xsNone;
|
|
27
|
+
// produção: libOpenSSL, cryOpenSSL, httpOpenSSL, xsLibXml2
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
Configuração mínima de NFC-e 4.00:
|
|
31
|
+
|
|
32
|
+
```pascal
|
|
33
|
+
ACBrNFe.Configuracoes.Geral.ModeloDF := moNFCe;
|
|
34
|
+
ACBrNFe.Configuracoes.Geral.VersaoDF := ve400;
|
|
35
|
+
ACBrNFe.Configuracoes.Geral.VersaoQRCode := veqr200;
|
|
36
|
+
ACBrNFe.Configuracoes.Geral.IdCSC := '000001';
|
|
37
|
+
ACBrNFe.Configuracoes.Geral.CSC := LCsc;
|
|
38
|
+
ACBrNFe.Configuracoes.WebServices.Ambiente := taHomologacao;
|
|
39
|
+
ACBrNFe.Configuracoes.WebServices.UF := LUf;
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Chave de 44 dígitos depois de `GerarNFe`:
|
|
43
|
+
|
|
44
|
+
```pascal
|
|
45
|
+
LChave := Copy(ACBrNFe.NotasFiscais.Items[0].NFe.infNFe.ID, 4, 44);
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Pasta de XML com caminho absoluto:
|
|
49
|
+
|
|
50
|
+
```pascal
|
|
51
|
+
LPastaXml := ExtractFilePath(ParamStr(0));
|
|
52
|
+
if LPastaXml.IsEmpty then
|
|
53
|
+
LPastaXml := GetCurrentDir;
|
|
54
|
+
LPastaXml := IncludeTrailingPathDelimiter(LPastaXml) + 'xml';
|
|
55
|
+
ForceDirectories(LPastaXml);
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
Forma de pagamento: PIX é `fpPagamentoInstantaneo` (código SEFAZ `17`). Em simulação sem certificado válido,
|
|
59
|
+
`NotasFiscais.Assinar` falha, mas o XML gerado por `GerarNFe` continua íntegro; trate a falha da assinatura como
|
|
60
|
+
aviso só nesse modo, nunca em produção.
|
package/templates/perfis/delphi/skills/conhecimento-delphi/references/build-via-bat-com-log.md
ADDED
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
# Build por `.bat` com log (para quem compila no Windows/VM)
|
|
2
|
+
|
|
3
|
+
**Este artigo é para o desenvolvedor que compila no Windows ou na VM, não para o agente.** O agente não compila: a
|
|
4
|
+
regra de build do perfil vale. O artigo serve para montar ou corrigir o `build.bat` do projeto e para ler o log que o
|
|
5
|
+
desenvolvedor devolver.
|
|
6
|
+
|
|
7
|
+
## Sintoma
|
|
8
|
+
|
|
9
|
+
- A saída do msbuild/`dcc32` chega cortada, com acento quebrado ou nem chega quando o build é chamado de outro shell
|
|
10
|
+
(MSYS, PowerShell).
|
|
11
|
+
- `cd` antes do `cmd.exe /c` não vale: o `cmd.exe` filho não herda a pasta corrente.
|
|
12
|
+
- O `.bat` diz "BUILD OK", mas o log tem `error E2010`.
|
|
13
|
+
- DUnitX falha com `ECommandLineError: Option [exit] expected a following :value but none was found`.
|
|
14
|
+
|
|
15
|
+
## Causa
|
|
16
|
+
|
|
17
|
+
- `2>&1` no shell externo nem sempre captura tudo, o compilador escreve em CP1252 e o buffer do PowerShell corta
|
|
18
|
+
linhas longas.
|
|
19
|
+
- `%ERRORLEVEL%` reflete o **último** comando: um `type "%LOG%"` antes do `exit /b %ERRORLEVEL%` devolve o código do
|
|
20
|
+
`type` (0) e mascara a falha.
|
|
21
|
+
- DUnitX exige `chave:valor`; a opção é `--exitbehavior:Continue`, não `--exit`.
|
|
22
|
+
|
|
23
|
+
## Correção
|
|
24
|
+
|
|
25
|
+
- O `.bat` redireciona toda a saída para um arquivo ao lado dele (`%~dp0build_log.txt`) e guarda o código do msbuild
|
|
26
|
+
numa variável **logo depois** do msbuild.
|
|
27
|
+
- Conferir o resultado pelo conteúdo do log (`error E`, `error F`, `Fatal`), não só pelo código de saída.
|
|
28
|
+
- `build_log.txt` e `test_log.txt` no `.claudeignore` e no `.gitignore`.
|
|
29
|
+
- Pergunte antes de fixar a versão no `.bat` se houver mais de uma pasta em `Studio\<N>.0\`, plataforma diferente de
|
|
30
|
+
Win32/Win64, configurações além de Debug/Release ou Community Edition (outro caminho de instalação).
|
|
31
|
+
|
|
32
|
+
| Pasta | Versão |
|
|
33
|
+
|---|---|
|
|
34
|
+
| `Studio\21.0` | Delphi 10.4 Sydney |
|
|
35
|
+
| `Studio\22.0` | Delphi 11 Alexandria |
|
|
36
|
+
| `Studio\23.0` | Delphi 12 Athens |
|
|
37
|
+
| `Studio\37.0` | Delphi 13 |
|
|
38
|
+
|
|
39
|
+
## Exemplo
|
|
40
|
+
|
|
41
|
+
```bat
|
|
42
|
+
@echo off
|
|
43
|
+
setlocal
|
|
44
|
+
set CONFIG=%1
|
|
45
|
+
if "%CONFIG%"=="" set CONFIG=Debug
|
|
46
|
+
set PLAT=%2
|
|
47
|
+
if "%PLAT%"=="" set PLAT=Win32
|
|
48
|
+
|
|
49
|
+
set RSVARS=C:\Program Files (x86)\Embarcadero\Studio\37.0\bin\rsvars.bat
|
|
50
|
+
if not exist "%RSVARS%" (
|
|
51
|
+
echo [build.bat] rsvars.bat nao encontrado em "%RSVARS%"
|
|
52
|
+
exit /b 2
|
|
53
|
+
)
|
|
54
|
+
call "%RSVARS%"
|
|
55
|
+
|
|
56
|
+
set LOG=%~dp0build_log.txt
|
|
57
|
+
msbuild "%~dp0SeuProjeto.dproj" /t:Build /p:Config=%CONFIG% /p:Platform=%PLAT% /nologo /v:minimal /clp:NoSummary > "%LOG%" 2>&1
|
|
58
|
+
set ERR=%ERRORLEVEL%
|
|
59
|
+
|
|
60
|
+
type "%LOG%"
|
|
61
|
+
if %ERR% EQU 0 (echo === BUILD OK %PLAT%\%CONFIG% ===) else (echo === BUILD FALHOU codigo %ERR% ===)
|
|
62
|
+
exit /b %ERR%
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
Chamada a partir de outro shell, sempre com caminho absoluto entre aspas:
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
cmd.exe /c '"C:\caminho\do\projeto\build.bat" 2>&1'
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
```powershell
|
|
72
|
+
& cmd.exe /c '"C:\caminho\do\projeto\build.bat" 2>&1'
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
## Erros de compilação que se resolvem com uma unit no `uses`
|
|
76
|
+
|
|
77
|
+
| Identificador | Unit |
|
|
78
|
+
|---|---|
|
|
79
|
+
| `TColor`, `TBitmap`, `TFont`, `TCanvas` | `Vcl.Graphics` (VCL) ou `FMX.Graphics` (FMX) |
|
|
80
|
+
| `TList<>`, `TObjectList<>`, `TDictionary<>` | `System.Generics.Collections` |
|
|
81
|
+
| `Format`, `IntToStr`, `Trim`, `FreeAndNil` | `System.SysUtils` |
|
|
82
|
+
| `IncDay`, `DaysBetween` | `System.DateUtils` |
|
|
83
|
+
| `TStringList`, `TStringStream` | `System.Classes` |
|
|
84
|
+
| `RGB`, `MessageBox`, `LoadCursor` | `Winapi.Windows` |
|
|
85
|
+
|
|
86
|
+
Linha de comando longa demais (`MSB6003`): `msb6003-command-line-too-long.md`.
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# `class var` contamina os campos seguintes — `E2356 Property accessor must be an instance field or method`
|
|
2
|
+
|
|
3
|
+
Aparece muito em código gerado e em singletons, porque o layout "bonito" (`class var` no topo, linha em branco,
|
|
4
|
+
campos de instância embaixo) é justamente o que produz o erro.
|
|
5
|
+
|
|
6
|
+
## Sintoma
|
|
7
|
+
|
|
8
|
+
```
|
|
9
|
+
MinhaUnit.pas(26): error E2356: Property accessor must be an instance field or method
|
|
10
|
+
MinhaUnit.pas(27): error E2356: Property accessor must be an instance field or method
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Um erro por **propriedade**, todas apontando para campos visivelmente declarados na classe, com tipo e visibilidade
|
|
14
|
+
corretos.
|
|
15
|
+
|
|
16
|
+
## Causa
|
|
17
|
+
|
|
18
|
+
`class var` abre uma seção que continua ativa até o próximo especificador de visibilidade (`private`, `public`...) ou
|
|
19
|
+
um `var` explícito. **Linha em branco não fecha a seção.** Os campos declarados depois viram variáveis de classe, e
|
|
20
|
+
propriedade de instância não pode ter variável de classe como acessor.
|
|
21
|
+
|
|
22
|
+
O erro é apontado na linha da propriedade, não na do campo, o que leva a investigação para o lado errado.
|
|
23
|
+
|
|
24
|
+
```pascal
|
|
25
|
+
type
|
|
26
|
+
TApiConfig = class
|
|
27
|
+
strict private
|
|
28
|
+
class var FInstancia: TApiConfig;
|
|
29
|
+
|
|
30
|
+
FPorta: Integer; // ainda é class var
|
|
31
|
+
FJwtSecret: string; // ainda é class var
|
|
32
|
+
public
|
|
33
|
+
class function Instancia: TApiConfig;
|
|
34
|
+
property Porta: Integer read FPorta; // E2356
|
|
35
|
+
property JwtSecret: string read FJwtSecret; // E2356
|
|
36
|
+
end;
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Correção
|
|
40
|
+
|
|
41
|
+
Nunca deixar `class var` e campos de instância na mesma seção. Três formas, em ordem de preferência:
|
|
42
|
+
|
|
43
|
+
1. `var` explícito para voltar aos campos de instância;
|
|
44
|
+
2. declarar o `class var` por último na seção;
|
|
45
|
+
3. isolar o `class var` numa seção de visibilidade própria.
|
|
46
|
+
|
|
47
|
+
## Exemplo
|
|
48
|
+
|
|
49
|
+
```pascal
|
|
50
|
+
// 1. var explícito
|
|
51
|
+
strict private
|
|
52
|
+
class var FInstancia: TApiConfig;
|
|
53
|
+
var
|
|
54
|
+
FPorta: Integer;
|
|
55
|
+
FJwtSecret: string;
|
|
56
|
+
|
|
57
|
+
// 2. class var por último
|
|
58
|
+
strict private
|
|
59
|
+
FPorta: Integer;
|
|
60
|
+
FJwtSecret: string;
|
|
61
|
+
class var FInstancia: TApiConfig;
|
|
62
|
+
public
|
|
63
|
+
|
|
64
|
+
// 3. seção própria
|
|
65
|
+
strict private
|
|
66
|
+
FPorta: Integer;
|
|
67
|
+
FJwtSecret: string;
|
|
68
|
+
strict private
|
|
69
|
+
class var FInstancia: TApiConfig;
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
Para achar o padrão antes de compilar: `grep -n -A6 "class var" *.pas` e verificar se há campo declarado depois do
|
|
73
|
+
`class var` sem `var` ou novo especificador de visibilidade no meio.
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# Controle fixo criado em runtime não aparece no Designer
|
|
2
|
+
|
|
3
|
+
## Sintoma
|
|
4
|
+
|
|
5
|
+
Um botão, label ou painel existe na tela em execução, mas não aparece no Form Designer nem na lista de componentes do
|
|
6
|
+
form. Quem for ajustar o layout pelo IDE não o encontra, e o visual fica diferente dos controles vizinhos.
|
|
7
|
+
|
|
8
|
+
## Causa
|
|
9
|
+
|
|
10
|
+
O controle foi criado em código (`TSpeedButton.Create(Self)` no `FormCreate`) em vez de declarado no `.dfm`/`.fmx`.
|
|
11
|
+
Só o que está no arquivo de form é visível no Designer, declarado na classe pelo IDE e tem eventos ligados por ele.
|
|
12
|
+
|
|
13
|
+
## Correção
|
|
14
|
+
|
|
15
|
+
- Controles **fixos** da tela: declarar no `.dfm`/`.fmx` e referenciar no `.pas`, seguindo o padrão visual dos
|
|
16
|
+
controles já existentes na mesma tela.
|
|
17
|
+
- Criação dinâmica só quando a **quantidade** é desconhecida em tempo de design: linhas geradas a partir de dados,
|
|
18
|
+
botões montados de uma lista, controles que dependem de configuração carregada em runtime.
|
|
19
|
+
|
|
20
|
+
## Exemplo
|
|
21
|
+
|
|
22
|
+
Errado:
|
|
23
|
+
|
|
24
|
+
```pascal
|
|
25
|
+
procedure TFrmCategorias.FormCreate(Sender: TObject);
|
|
26
|
+
begin
|
|
27
|
+
FBtnNova := TSpeedButton.Create(Self);
|
|
28
|
+
FBtnNova.Parent := pnlBotoes;
|
|
29
|
+
FBtnNova.Caption := 'Nova';
|
|
30
|
+
FBtnNova.OnClick := BtnNovaClick;
|
|
31
|
+
end;
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Certo:
|
|
35
|
+
|
|
36
|
+
```
|
|
37
|
+
object btnNova: TSpeedButton
|
|
38
|
+
Caption = 'Nova'
|
|
39
|
+
OnClick = btnNovaClick
|
|
40
|
+
end
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
```pascal
|
|
44
|
+
published
|
|
45
|
+
btnNova: TSpeedButton;
|
|
46
|
+
procedure btnNovaClick(Sender: TObject);
|
|
47
|
+
```
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# App console: `Writeln` sem `Flush` não aparece em log redirecionado
|
|
2
|
+
|
|
3
|
+
Vale para qualquer `{$APPTYPE CONSOLE}`: servidor Horse, worker, serviço, ferramenta de linha de comando.
|
|
4
|
+
|
|
5
|
+
## Sintoma
|
|
6
|
+
|
|
7
|
+
A aplicação está viva e responde normalmente, mas o arquivo que captura a saída fica com **0 bytes**:
|
|
8
|
+
|
|
9
|
+
```powershell
|
|
10
|
+
Start-Process .\MinhaApi.exe -RedirectStandardOutput out.txt -RedirectStandardError err.txt
|
|
11
|
+
# ... a API responde HTTP 200 ...
|
|
12
|
+
Get-Item out.txt # Length: 0
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
No console interativo a mesma linha aparece, o que dá a impressão de que só o redirecionamento está quebrado. Se o
|
|
16
|
+
processo é encerrado à força (`taskkill /F`, `Stop-Process -Force`, Ctrl+C sem tratamento), toda a saída some,
|
|
17
|
+
inclusive mensagens de erro que explicariam a falha.
|
|
18
|
+
|
|
19
|
+
## Causa
|
|
20
|
+
|
|
21
|
+
Com `Output` ligado a um console, cada `Writeln` sai na hora. Redirecionado para arquivo ou pipe, o runtime passa a
|
|
22
|
+
usar buffer cheio (alguns KB), descarregado só quando enche, quando a aplicação termina normalmente ou quando alguém
|
|
23
|
+
chama `Flush(Output)`. Um servidor que fica no ar não cumpre nenhuma das condições; um processo morto descarta o
|
|
24
|
+
buffer.
|
|
25
|
+
|
|
26
|
+
## Correção
|
|
27
|
+
|
|
28
|
+
- `Flush(Output)` depois de cada bloco que precisa aparecer imediatamente.
|
|
29
|
+
- Para log de servidor, não depender do stdout: gravar em arquivo próprio, com append e descarga a cada linha.
|
|
30
|
+
- Antes de usar o log de uma aplicação para diagnóstico ou automação de teste, confirmar que ele **existe e tem
|
|
31
|
+
conteúdo**; sem log, uma aplicação console não deixa rastro nenhum, e num servidor Horse o único sinal de erro
|
|
32
|
+
passa a ser o corpo do HTTP 500.
|
|
33
|
+
|
|
34
|
+
## Exemplo
|
|
35
|
+
|
|
36
|
+
```pascal
|
|
37
|
+
THorse.Listen(LPorta,
|
|
38
|
+
procedure
|
|
39
|
+
begin
|
|
40
|
+
Writeln(Format('API rodando na porta %d', [LPorta]));
|
|
41
|
+
Writeln('Swagger UI: http://localhost:' + LPorta.ToString + '/swagger/doc/html');
|
|
42
|
+
Flush(Output); // sem isto, nada aparece em saída redirecionada
|
|
43
|
+
end);
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Diagnóstico rápido: processo vivo (`Get-Process -Name MinhaApi`) e arquivo de captura com 0 bytes indicam buffer
|
|
47
|
+
retido, não código que deixou de executar.
|
package/templates/perfis/delphi/skills/conhecimento-delphi/references/conversao-numerica-locale.md
ADDED
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# Conversão numérica e o separador decimal do locale
|
|
2
|
+
|
|
3
|
+
## Sintoma
|
|
4
|
+
|
|
5
|
+
Valor preenchido "some": `StrToCurrDef`/`StrToFloatDef` devolvem o padrão (0) sem exceção, e a validação "informe o
|
|
6
|
+
valor" dispara com o campo preenchido. Com `StrToFloat`/`StrToCurr`, aparece `'37.55' is not a valid floating point
|
|
7
|
+
value` só em algumas máquinas, ou `'1.234,56' is not a valid floating point value` em todas. O mesmo código funciona
|
|
8
|
+
no computador do desenvolvedor e falha no do cliente (ou o contrário).
|
|
9
|
+
|
|
10
|
+
## Causa
|
|
11
|
+
|
|
12
|
+
- `StrToFloat`, `StrToCurr`, as versões `...Def` e `Try...` usam por padrão o `FormatSettings` global, que vem da
|
|
13
|
+
configuração regional da máquina. Em pt-BR o decimal é vírgula. Trocar `,` por `.` "para virar decimal" faz a
|
|
14
|
+
conversão falhar porque o ponto não é o separador decimal configurado: o texto deixa de ser um número válido.
|
|
15
|
+
- Essas funções **não aceitam separador de milhar**. `ThousandSeparator` só é usado na formatação (`FormatFloat`,
|
|
16
|
+
`Format` com `%n`); defini-lo como `'.'` não faz `'1.234,56'` converter.
|
|
17
|
+
- `FloatToStr`/`FormatFloat` também dependem do locale na volta.
|
|
18
|
+
|
|
19
|
+
## Correção
|
|
20
|
+
|
|
21
|
+
Converter a string **no formato em que ela está**, com um `TFormatSettings` explícito (unit `System.SysUtils`;
|
|
22
|
+
sobrecarga disponível desde o XE). O `TFormatSettings` descreve a **entrada**, não a saída desejada:
|
|
23
|
+
|
|
24
|
+
- texto digitado na tela em formato brasileiro: `DecimalSeparator := ','`; se o texto puder trazer milhar
|
|
25
|
+
(`1.234,56`), remover os pontos **antes** de converter;
|
|
26
|
+
- texto vindo de arquivo, API ou SQL com ponto decimal e sem milhar: `TFormatSettings.Invariant`.
|
|
27
|
+
|
|
28
|
+
## Exemplo
|
|
29
|
+
|
|
30
|
+
```pascal
|
|
31
|
+
// errado em máquina pt-BR
|
|
32
|
+
LTexto := Edit.Text.Replace(',', '.');
|
|
33
|
+
Result := StrToCurrDef(LTexto, 0);
|
|
34
|
+
|
|
35
|
+
// certo: formato brasileiro explícito, milhar removido antes da conversão
|
|
36
|
+
var
|
|
37
|
+
LFormato: TFormatSettings;
|
|
38
|
+
begin
|
|
39
|
+
LFormato := TFormatSettings.Create;
|
|
40
|
+
LFormato.DecimalSeparator := ',';
|
|
41
|
+
Result := StrToCurrDef(Edit.Text.Trim.Replace('.', ''), 0, LFormato);
|
|
42
|
+
end;
|
|
43
|
+
|
|
44
|
+
// texto com ponto decimal (JSON, arquivo, retorno de API)
|
|
45
|
+
LValor := StrToFloat(LJsonValor, TFormatSettings.Invariant);
|
|
46
|
+
LTexto := FloatToStr(LValor, TFormatSettings.Invariant);
|
|
47
|
+
```
|
package/templates/perfis/delphi/skills/conhecimento-delphi/references/delphi13-breaking-changes.md
ADDED
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# Delphi 13 (RAD Studio 37.0): quebras de API na migração
|
|
2
|
+
|
|
3
|
+
Quebras que aparecem ao compilar no Delphi 13 código que vinha do 12.x ou anterior. A lista cobre o que foi
|
|
4
|
+
confirmado; quebra nova deve ser conferida no fonte da RTL/FMX instalada (`$(BDS)\source`).
|
|
5
|
+
|
|
6
|
+
## `TAniCalculations.Interval` removida (FMX)
|
|
7
|
+
|
|
8
|
+
### Sintoma
|
|
9
|
+
|
|
10
|
+
```
|
|
11
|
+
[DCC Error] E2003 Undeclared identifier: 'Interval'
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
numa linha como:
|
|
15
|
+
|
|
16
|
+
```pascal
|
|
17
|
+
ScrollBox.AniCalculations.Interval := 100;
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
### Causa
|
|
21
|
+
|
|
22
|
+
Até o 12.x, `FMX.InertialMovement` expunha `Interval` (ms do timer que recalculava a inércia). No 13, a engine passou
|
|
23
|
+
a usar `TDisplayLinkService`, sincronizado com a taxa de atualização da tela; o campo virou privado e a propriedade
|
|
24
|
+
pública foi removida, sem substituta.
|
|
25
|
+
|
|
26
|
+
### Correção
|
|
27
|
+
|
|
28
|
+
Remover a linha: a engine ajusta o intervalo sozinha.
|
|
29
|
+
|
|
30
|
+
### Exemplo
|
|
31
|
+
|
|
32
|
+
```pascal
|
|
33
|
+
// antes
|
|
34
|
+
vert.AniCalculations.Animation := True;
|
|
35
|
+
vert.AniCalculations.Interval := 100;
|
|
36
|
+
|
|
37
|
+
// depois
|
|
38
|
+
vert.AniCalculations.Animation := True;
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Para achar todas as ocorrências antes de compilar: `grep -rn "AniCalculations\.Interval" .`
|
package/templates/perfis/delphi/skills/conhecimento-delphi/references/dpr-uses-project-manager.md
ADDED
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# Unit fora do `uses` do `.dpr` não aparece no Project Manager
|
|
2
|
+
|
|
3
|
+
## Sintoma
|
|
4
|
+
|
|
5
|
+
- A unit compila, mas não aparece no Project Manager do IDE.
|
|
6
|
+
- O Designer não abre o form/frame e diz "No form found".
|
|
7
|
+
- O IDE reclama de duplicidade ao abrir o `.dpr`.
|
|
8
|
+
|
|
9
|
+
Acontece quando os arquivos são criados fora do IDE (editor externo, script, agente).
|
|
10
|
+
|
|
11
|
+
## Causa
|
|
12
|
+
|
|
13
|
+
O Project Manager lê a seção `uses` do `.dpr`, não o `.dproj`. Uma `<DCCReference>` só no `.dproj` faz o compilador
|
|
14
|
+
achar a unit, mas não a expõe no IDE. O sufixo entre chaves (`{NomeClasse}`, `{NomeClasse: TFrame}`) diz ao IDE qual
|
|
15
|
+
é a classe principal e o tipo base; sem ele o Designer não abre. Duplicidade vem de `.dpr` e `.dproj` apontando a
|
|
16
|
+
mesma unit com caminhos ligeiramente diferentes (`/` contra `\`, caixa diferente).
|
|
17
|
+
|
|
18
|
+
## Correção
|
|
19
|
+
|
|
20
|
+
Toda unit nova entra nos **dois** arquivos, com o mesmo caminho, usando `\` e a mesma caixa:
|
|
21
|
+
|
|
22
|
+
| Tipo | Cláusula no `.dpr` |
|
|
23
|
+
|---|---|
|
|
24
|
+
| Unit de código | `Nome in 'pasta\Nome.pas',` |
|
|
25
|
+
| Form | `NomeUnit in 'pasta\NomeUnit.pas' {NomeForm},` |
|
|
26
|
+
| Frame | `NomeUnit in 'pasta\NomeUnit.pas' {NomeFrame: TFrame},` |
|
|
27
|
+
| DataModule | `NomeUnit in 'pasta\NomeUnit.pas' {NomeDM: TDataModule},` |
|
|
28
|
+
|
|
29
|
+
Pelo IDE (**File → New** ou **Project → Add to Project**) os dois arquivos são atualizados juntos.
|
|
30
|
+
|
|
31
|
+
## Exemplo
|
|
32
|
+
|
|
33
|
+
```pascal
|
|
34
|
+
program MeuApp;
|
|
35
|
+
|
|
36
|
+
uses
|
|
37
|
+
Vcl.Forms,
|
|
38
|
+
AppConfig in 'src\infra\AppConfig.pas',
|
|
39
|
+
Repository.Produto in 'src\repositories\Repository.Produto.pas',
|
|
40
|
+
FrameHome in 'src\frames\FrameHome.pas' {FrameHome: TFrame},
|
|
41
|
+
DMConexao in 'src\dados\DMConexao.pas' {DmConexao: TDataModule},
|
|
42
|
+
FormMain in 'src\forms\FormMain.pas' {FrmMain};
|
|
43
|
+
|
|
44
|
+
{$R *.res}
|
|
45
|
+
|
|
46
|
+
begin
|
|
47
|
+
Application.Initialize;
|
|
48
|
+
Application.CreateForm(TFrmMain, FrmMain);
|
|
49
|
+
Application.Run;
|
|
50
|
+
end.
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
```xml
|
|
54
|
+
<DCCReference Include="src\infra\AppConfig.pas"/>
|
|
55
|
+
<DCCReference Include="src\frames\FrameHome.pas">
|
|
56
|
+
<Form>FrameHome</Form>
|
|
57
|
+
<FormType>dfm</FormType>
|
|
58
|
+
<DesignClass>TFrame</DesignClass>
|
|
59
|
+
</DCCReference>
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
Em FMX, `<FormType>` é `fmx`.
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
# `DCC_DebugInformation` não é booleano — `F1026 File not found: 'true.dpr'`
|
|
2
|
+
|
|
3
|
+
Atinge `.dproj` escrito ou gerado fora do IDE (agente, script, template), onde é natural pôr `true`/`false` em toda
|
|
4
|
+
propriedade que "parece booleana".
|
|
5
|
+
|
|
6
|
+
## Sintoma
|
|
7
|
+
|
|
8
|
+
```
|
|
9
|
+
CodeGear.Delphi.Targets(431,5): error F1026: File not found: 'true.dpr'
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
O projeto se chama `MinhaApi.dpr`; `true.dpr` não existe e a palavra `true` não aparece no `.dpr`. Nenhuma linha de
|
|
13
|
+
código chega a ser compilada: o build morre antes. Confirmado no RAD Studio 37.0 (Delphi 13); o mecanismo vale para
|
|
14
|
+
qualquer versão moderna.
|
|
15
|
+
|
|
16
|
+
## Causa
|
|
17
|
+
|
|
18
|
+
O `.dproj` tem:
|
|
19
|
+
|
|
20
|
+
```xml
|
|
21
|
+
<DCC_DebugInformation>true</DCC_DebugInformation>
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
`DCC_DebugInformation` é um **enum numérico** (`0` = informação de debug completa, `2` = nenhuma). O
|
|
25
|
+
`CodeGear.Delphi.Targets` repassa o valor cru à task do compilador (`DebugInformation="$(DCC_DebugInformation)"`), sem
|
|
26
|
+
validar. O valor desconhecido vira um token solto na linha de comando:
|
|
27
|
+
|
|
28
|
+
```
|
|
29
|
+
dcc32.exe -$O- -$W+ true --no-config -B -Q ...
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
O `dcc32` entende esse `true` como o arquivo-fonte a compilar, acrescenta `.dpr` e procura `true.dpr`.
|
|
33
|
+
|
|
34
|
+
## Correção
|
|
35
|
+
|
|
36
|
+
Usar o valor numérico, como o IDE grava:
|
|
37
|
+
|
|
38
|
+
```xml
|
|
39
|
+
<PropertyGroup Condition="'$(Cfg_1)'!=''"> <!-- Debug -->
|
|
40
|
+
<DCC_Define>DEBUG;$(DCC_Define)</DCC_Define>
|
|
41
|
+
<DCC_Optimize>false</DCC_Optimize>
|
|
42
|
+
<DCC_GenerateStackFrames>true</DCC_GenerateStackFrames>
|
|
43
|
+
<DCC_DebugInformation>0</DCC_DebugInformation>
|
|
44
|
+
<DCC_DebugInfoInExe>true</DCC_DebugInfoInExe>
|
|
45
|
+
</PropertyGroup>
|
|
46
|
+
|
|
47
|
+
<PropertyGroup Condition="'$(Cfg_2)'!=''"> <!-- Release -->
|
|
48
|
+
<DCC_Define>RELEASE;$(DCC_Define)</DCC_Define>
|
|
49
|
+
<DCC_Optimize>true</DCC_Optimize>
|
|
50
|
+
<DCC_GenerateStackFrames>false</DCC_GenerateStackFrames>
|
|
51
|
+
<DCC_DebugInformation>2</DCC_DebugInformation>
|
|
52
|
+
</PropertyGroup>
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
| Propriedade | Tipo | Valores |
|
|
56
|
+
|---|---|---|
|
|
57
|
+
| `DCC_Optimize` | booleana | `true` / `false` |
|
|
58
|
+
| `DCC_GenerateStackFrames` | booleana | `true` / `false` |
|
|
59
|
+
| `DCC_DebugInfoInExe` | booleana | `true` / `false` |
|
|
60
|
+
| **`DCC_DebugInformation`** | **enum numérico** | `0` (debug) / `2` (nenhuma) |
|
|
61
|
+
|
|
62
|
+
**Não invente o tipo de uma propriedade do `.dproj`.** A referência confiável é um `.dproj` salvo pelo próprio IDE
|
|
63
|
+
na mesma versão do RAD Studio: crie um projeto vazio e compare.
|
|
64
|
+
|
|
65
|
+
## Exemplo de diagnóstico
|
|
66
|
+
|
|
67
|
+
Quando o erro citar um arquivo inexistente cujo nome parece um **valor** (`true.dpr`, `false.dpr`, `0.dpr`), quem
|
|
68
|
+
compila no Windows pode gerar o log com verbosidade diagnóstica e procurar a linha do compilador:
|
|
69
|
+
|
|
70
|
+
```
|
|
71
|
+
msbuild Projeto.dproj /t:Build /v:diag > diag.txt
|
|
72
|
+
findstr /C:"dcc32.exe" diag.txt
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
O token solto aparece na linha; a propriedade que o produziu é a do switch imediatamente anterior. Sem acesso ao
|
|
76
|
+
build, procure no `.dproj` por propriedades `DCC_*` com `true`/`false` e confira o tipo na tabela acima.
|
|
77
|
+
|
|
78
|
+
Outra armadilha de `.dproj` escrito à mão: `dproj-projectguid-valido.md`.
|
package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-projectguid-valido.md
ADDED
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# `ProjectGuid` precisa ser um GUID hexadecimal válido
|
|
2
|
+
|
|
3
|
+
Atinge `.dproj` criado fora do IDE (agente ou script gerando o projeto).
|
|
4
|
+
|
|
5
|
+
## Sintoma
|
|
6
|
+
|
|
7
|
+
O projeto compila pela linha de comando, mas o RAD Studio se recusa a abri-lo:
|
|
8
|
+
|
|
9
|
+
```
|
|
10
|
+
Unable to load project ...\DemoChat.dproj
|
|
11
|
+
'{A1B2C3D4-0002-4ABC-9DEF-0001DEMOCHAT}' is not a valid GUID value
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Causa
|
|
15
|
+
|
|
16
|
+
O `<ProjectGuid>` recebeu um marcador "legível" com letras que não são hexadecimais (`M`, `H`, `T`, `O`...). Um GUID
|
|
17
|
+
válido tem 32 dígitos hexadecimais (`0-9`, `A-F`) no formato `{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}`.
|
|
18
|
+
|
|
19
|
+
O msbuild e o `dcc32` **ignoram** o campo; só o IDE o valida. Por isso um build verde pela linha de comando não
|
|
20
|
+
garante que o projeto abre no IDE.
|
|
21
|
+
|
|
22
|
+
## Correção
|
|
23
|
+
|
|
24
|
+
Gerar um GUID de verdade:
|
|
25
|
+
|
|
26
|
+
- PowerShell: `[guid]::NewGuid().ToString().ToUpper()`
|
|
27
|
+
- Delphi: `CreateGUID` + `GUIDToString`
|
|
28
|
+
- macOS/Linux: `uuidgen`
|
|
29
|
+
|
|
30
|
+
## Exemplo
|
|
31
|
+
|
|
32
|
+
```xml
|
|
33
|
+
<ProjectGuid>{C2DA9E20-AA07-4515-999D-4713D17196BB}</ProjectGuid>
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Ao abrir um `.dproj` mínimo feito à mão, o RAD Studio costuma reescrevê-lo por inteiro (grupos de plataforma,
|
|
37
|
+
VerInfo etc.). É esperado: confira que os blocos críticos (por exemplo `DCC_UnitSearchPath` e defines) sobreviveram
|
|
38
|
+
e versione a versão gravada pelo IDE.
|