@fontdata/ai-harness 4.3.1 → 4.5.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 +154 -3
- package/dist/cli.js +1 -0
- package/dist/config/config.js +45 -3
- package/dist/delphi/catalogo.js +299 -0
- package/dist/delphi/classificar.js +21 -0
- package/dist/delphi/command.js +144 -2
- package/dist/delphi/encoding.js +112 -0
- package/dist/doctor/checks.js +19 -1
- package/dist/init.js +16 -2
- package/dist/install/perfis.js +21 -0
- package/dist/install/plan.js +29 -2
- package/dist/install/settings.js +40 -3
- package/dist/mapa/extratores/pascal.js +1 -1
- package/dist/update/update.js +126 -7
- package/package.json +1 -1
- package/templates/CLAUDE.md +2 -1
- package/templates/catalog.json +11 -3
- package/templates/hooks/comentarios/check.mjs +62 -5
- package/templates/hooks/hooks.json +2 -1
- package/templates/hooks/lib/config.mjs +1 -0
- package/templates/hooks/padroes-proibidos.mjs +68 -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 +70 -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/perfis/delphi-fiscal/rules/campo-novo-acbr-preenchimento-explicito.md +61 -0
- package/templates/perfis/delphi-fiscal/rules/retorno-de-evento-nfe-pelo-cstat.md +51 -0
- package/templates/perfis/delphi-fiscal/rules/sucesso-de-webservice-fiscal-nao-prova-documento.md +100 -0
- package/templates/perfis/delphi-fiscal/rules/total-tributo-acbr-soma-itens.md +63 -0
- package/templates/perfis/delphi-fiscal/skills/diagnosticar-rejeicao-nfse/SKILL.md +155 -0
- package/templates/perfis/delphi-fiscal/skills/patch-acbr/SKILL.md +143 -0
- package/templates/skills/auditar-performance/SKILL.md +9 -0
- package/templates/skills/auditar-performance/references/pontos-quentes.md +8 -0
- package/templates/skills/auditar-seguranca/SKILL.md +55 -14
- package/templates/skills/auditar-seguranca/templates/relatorios/TECNICO.md +5 -0
- package/templates/skills/auditar-ui/SKILL.md +18 -3
- package/templates/skills/auditar-ui/references/ATRIBUICAO.md +44 -0
- package/templates/skills/auditar-ui/references/web-interface-guidelines.md +191 -0
- package/templates/skills/harness/references/validar-ideia.md +7 -6
- package/templates/skills/security-audit/AI-AND-LLM.md +83 -0
- package/templates/skills/security-audit/ATTACK-CLASSES.md +130 -0
- package/templates/skills/security-audit/CLIENT-SIDE.md +83 -0
- package/templates/skills/security-audit/CLOUD-AND-DEPLOYMENT.md +86 -0
- package/templates/skills/security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -0
- package/templates/skills/security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -0
- package/templates/skills/security-audit/HUNTING.md +251 -0
- package/templates/skills/security-audit/LICENSE +21 -0
- package/templates/skills/security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -0
- package/templates/skills/security-audit/ORIGEM.md +51 -0
- package/templates/skills/security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -0
- package/templates/skills/security-audit/RECONNAISSANCE.md +156 -0
- package/templates/skills/security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -0
- package/templates/skills/security-audit/SKILL.md +192 -0
- package/templates/skills/security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -0
- package/templates/skills/security-audit/VALIDATION-AND-REPORTING.md +186 -0
- package/templates/skills/security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -0
- package/templates/skills/security-audit/report-schema.json +461 -0
- package/templates/skills/security-audit/validate-coverage-ledger.cjs +872 -0
- package/templates/skills/security-audit/validate-findings.cjs +773 -0
- package/templates/skills/supabase-postgres-best-practices/CHANGELOG.md +73 -0
- package/templates/skills/supabase-postgres-best-practices/LICENSE +21 -0
- package/templates/skills/supabase-postgres-best-practices/ORIGEM.md +43 -0
- package/templates/skills/supabase-postgres-best-practices/SKILL.md +64 -0
- package/templates/skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
- package/templates/skills/supabase-postgres-best-practices/references/_sections.md +39 -0
- package/templates/skills/supabase-postgres-best-practices/references/_template.md +34 -0
- package/templates/skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
- package/templates/skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
- package/templates/skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
- package/templates/skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
- package/templates/skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/security-rls-performance.md +63 -0
- package/templates/skills/vercel-react-best-practices/AGENTS.md +3810 -0
- package/templates/skills/vercel-react-best-practices/ORIGEM.md +39 -0
- package/templates/skills/vercel-react-best-practices/README.md +123 -0
- package/templates/skills/vercel-react-best-practices/SKILL.md +149 -0
- package/templates/skills/vercel-react-best-practices/metadata.json +15 -0
- package/templates/skills/vercel-react-best-practices/rules/_sections.md +46 -0
- package/templates/skills/vercel-react-best-practices/rules/_template.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
- package/templates/skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
- package/templates/skills/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
- package/templates/skills/vercel-react-best-practices/rules/async-defer-await.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
- package/templates/skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
- package/templates/skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
- package/templates/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
- package/templates/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
- package/templates/skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
- package/templates/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
- package/templates/skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
- package/templates/skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
- package/templates/skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
- package/templates/skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
- package/templates/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
- package/templates/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
- package/templates/skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
- package/templates/skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
- package/templates/skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
- package/templates/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
- package/templates/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
- package/templates/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
- package/templates/skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
- package/templates/skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
- package/templates/skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
- package/templates/skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
- package/templates/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
- package/templates/skills/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
- package/templates/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
- package/templates/skills/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
- package/templates/skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
- package/templates/skills/vercel-react-native-skills/AGENTS.md +2897 -0
- package/templates/skills/vercel-react-native-skills/ORIGEM.md +39 -0
- package/templates/skills/vercel-react-native-skills/README.md +165 -0
- package/templates/skills/vercel-react-native-skills/SKILL.md +121 -0
- package/templates/skills/vercel-react-native-skills/metadata.json +16 -0
- package/templates/skills/vercel-react-native-skills/rules/_sections.md +86 -0
- package/templates/skills/vercel-react-native-skills/rules/_template.md +28 -0
- package/templates/skills/vercel-react-native-skills/rules/animation-derived-value.md +53 -0
- package/templates/skills/vercel-react-native-skills/rules/animation-gesture-detector-press.md +95 -0
- package/templates/skills/vercel-react-native-skills/rules/animation-gpu-properties.md +65 -0
- package/templates/skills/vercel-react-native-skills/rules/design-system-compound-components.md +66 -0
- package/templates/skills/vercel-react-native-skills/rules/fonts-config-plugin.md +71 -0
- package/templates/skills/vercel-react-native-skills/rules/imports-design-system-folder.md +68 -0
- package/templates/skills/vercel-react-native-skills/rules/js-hoist-intl.md +61 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-callbacks.md +44 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-function-references.md +132 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-images.md +53 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-inline-objects.md +97 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-item-expensive.md +94 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-item-memo.md +82 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-item-types.md +104 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-virtualize.md +67 -0
- package/templates/skills/vercel-react-native-skills/rules/monorepo-native-deps-in-app.md +46 -0
- package/templates/skills/vercel-react-native-skills/rules/monorepo-single-dependency-versions.md +63 -0
- package/templates/skills/vercel-react-native-skills/rules/navigation-native-navigators.md +188 -0
- package/templates/skills/vercel-react-native-skills/rules/react-compiler-destructure-functions.md +50 -0
- package/templates/skills/vercel-react-native-skills/rules/react-compiler-reanimated-shared-values.md +48 -0
- package/templates/skills/vercel-react-native-skills/rules/react-state-dispatcher.md +91 -0
- package/templates/skills/vercel-react-native-skills/rules/react-state-fallback.md +56 -0
- package/templates/skills/vercel-react-native-skills/rules/react-state-minimize.md +65 -0
- package/templates/skills/vercel-react-native-skills/rules/rendering-no-falsy-and.md +74 -0
- package/templates/skills/vercel-react-native-skills/rules/rendering-text-in-text-component.md +36 -0
- package/templates/skills/vercel-react-native-skills/rules/scroll-position-no-state.md +82 -0
- package/templates/skills/vercel-react-native-skills/rules/state-ground-truth.md +80 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-expo-image.md +66 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-image-gallery.md +104 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-measure-views.md +78 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-menus.md +174 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-native-modals.md +77 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-pressable.md +61 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-safe-area-scroll.md +65 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-scrollview-content-inset.md +45 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-styling.md +87 -0
|
@@ -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.
|
package/templates/perfis/delphi/skills/conhecimento-delphi/references/firedac-registro-drivers.md
ADDED
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
# Driver FireDAC não encontrado — "Object factory for class ... is missing"
|
|
2
|
+
|
|
3
|
+
## Sintoma
|
|
4
|
+
|
|
5
|
+
Na primeira conexão ou consulta, em runtime:
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
Object factory for class {3E9B315B-F456-4175-A864-B2573C4A2201} is missing.
|
|
9
|
+
To register it, you can drop component [TFDGUIxWaitCursor] into your project.
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
O GUID varia; o que importa é o nome da classe na mensagem (`TFDGUIxWaitCursor`, `TFDPhysSQLiteDriverLink`,
|
|
13
|
+
`TFDStanJSONFile`...). No mobile com SQLite, a variante é:
|
|
14
|
+
|
|
15
|
+
```
|
|
16
|
+
[FireDAC][Phys][SQLite]-314. Cannot load vendor library [libsqlite.so or libdb_sql.so].
|
|
17
|
+
dlopen failed: library "libdb_sql.so" not found
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
## Causa
|
|
21
|
+
|
|
22
|
+
O FireDAC separa drivers e UI em units que se registram no `initialization`. Se nenhuma unit da cadeia de `uses` as
|
|
23
|
+
referencia, o linker não as inclui e a classe não é registrada. Acontece em projetos sem DataModule (conexão criada
|
|
24
|
+
em código), porque quem arrasta o componente no Designer ganha as units e a instância de
|
|
25
|
+
graça.
|
|
26
|
+
|
|
27
|
+
Duas pegadinhas:
|
|
28
|
+
|
|
29
|
+
- **Registrar a classe não basta.** `FireDAC.ConsoleUI.Wait` só registra `TFDGUIxWaitCursor`; sem DataModule, é
|
|
30
|
+
preciso criar a **instância** do componente.
|
|
31
|
+
- **SQLite no Android/iOS exige linkagem estática:** `slDefault`/`slDynamic` tentam `dlopen` de uma biblioteca do
|
|
32
|
+
sistema que o app não alcança. O Designer grava `EngineLinkage = slStatic` no `.dfm`; em código, é preciso setar.
|
|
33
|
+
|
|
34
|
+
## Correção
|
|
35
|
+
|
|
36
|
+
No `uses` de uma unit viva no projeto (normalmente a de conexão), incluir conforme o uso:
|
|
37
|
+
|
|
38
|
+
| Banco | Units |
|
|
39
|
+
|---|---|
|
|
40
|
+
| SQLite | `FireDAC.Phys.SQLite`, `FireDAC.Phys.SQLiteDef` (+ `FireDAC.Phys.SQLiteWrapper.Stat` no mobile) |
|
|
41
|
+
| MySQL/MariaDB | `FireDAC.Phys.MySQL`, `FireDAC.Phys.MySQLDef` |
|
|
42
|
+
| PostgreSQL | `FireDAC.Phys.PG`, `FireDAC.Phys.PGDef` |
|
|
43
|
+
|
|
44
|
+
| Tipo de aplicação | Unit de espera (escolha uma) |
|
|
45
|
+
|---|---|
|
|
46
|
+
| VCL | `FireDAC.VCLUI.Wait` |
|
|
47
|
+
| Console, serviço, mobile | `FireDAC.ConsoleUI.Wait` |
|
|
48
|
+
| FMX desktop | `FireDAC.ConsoleUI.Wait` ou `FireDAC.FMXUI.Wait` |
|
|
49
|
+
|
|
50
|
+
| Unit | Para quê |
|
|
51
|
+
|---|---|
|
|
52
|
+
| `FireDAC.DApt` | necessária para `Open`/`Fetch` de queries |
|
|
53
|
+
| `FireDAC.Stan.ExprFuncs` | funções de expressão em filtros locais |
|
|
54
|
+
| `FireDAC.Stan.JSONFile` / `FireDAC.Stan.StorageBin` | salvar/carregar dataset em JSON ou binário |
|
|
55
|
+
|
|
56
|
+
A unit de setup precisa ser referenciada antes de qualquer acesso a banco no boot (primeiras posições do `uses` do
|
|
57
|
+
`.dpr`). Em Delphi 10.3 e anteriores, `EngineLinkage := slStatic` se escreve `StaticLink := True`.
|
|
58
|
+
|
|
59
|
+
Outro GUID da mesma família: procure o nome da classe em `$(BDS)\source\data\firedac\`; a unit que a registra é a que
|
|
60
|
+
falta no `uses`.
|
|
61
|
+
|
|
62
|
+
## Exemplo
|
|
63
|
+
|
|
64
|
+
Unit de setup sem DataModule:
|
|
65
|
+
|
|
66
|
+
```pascal
|
|
67
|
+
unit App.Infra.FireDAC.Setup;
|
|
68
|
+
|
|
69
|
+
interface
|
|
70
|
+
|
|
71
|
+
implementation
|
|
72
|
+
|
|
73
|
+
uses
|
|
74
|
+
FireDAC.Phys.SQLite, FireDAC.Phys.SQLiteDef, FireDAC.Phys.SQLiteWrapper.Stat,
|
|
75
|
+
FireDAC.Stan.ExprFuncs, FireDAC.Stan.Intf, FireDAC.UI.Intf,
|
|
76
|
+
FireDAC.Comp.UI, FireDAC.ConsoleUI.Wait, FireDAC.DApt;
|
|
77
|
+
|
|
78
|
+
var
|
|
79
|
+
FWaitCursor: TFDGUIxWaitCursor;
|
|
80
|
+
FSQLiteDriver: TFDPhysSQLiteDriverLink;
|
|
81
|
+
|
|
82
|
+
initialization
|
|
83
|
+
FWaitCursor := TFDGUIxWaitCursor.Create(nil);
|
|
84
|
+
FWaitCursor.Provider := 'Console';
|
|
85
|
+
FWaitCursor.ScreenCursor := gcrNone;
|
|
86
|
+
FSQLiteDriver := TFDPhysSQLiteDriverLink.Create(nil);
|
|
87
|
+
FSQLiteDriver.EngineLinkage := slStatic;
|
|
88
|
+
|
|
89
|
+
finalization
|
|
90
|
+
FSQLiteDriver.Free;
|
|
91
|
+
FWaitCursor.Free;
|
|
92
|
+
|
|
93
|
+
end.
|
|
94
|
+
```
|
package/templates/perfis/delphi/skills/conhecimento-delphi/references/horse-gbswagger-rotas-jwt.md
ADDED
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# Horse + gbswagger + JWT: rota que muda, rota que some e 401 no Swagger
|
|
2
|
+
|
|
3
|
+
Para projetos Delphi com Horse que documentam rotas com `Horse.GBSwagger` e protegem com `Horse.JWT`. Superfície de
|
|
4
|
+
API confirmada no gbswagger 3.1.0; a versão instalada pelo Boss em `modules/` é a única verdade, leia a interface ali
|
|
5
|
+
antes de escrever código de memória.
|
|
6
|
+
|
|
7
|
+
## Sintoma
|
|
8
|
+
|
|
9
|
+
1. Depois de converter um controller para o padrão de classe gbswagger, o cliente (app mobile) passa a receber 404:
|
|
10
|
+
`/cargo` virou `/v1/cargo`.
|
|
11
|
+
2. O projeto compila e sobe, mas as rotas anotadas **não existem**; o build só mostrou
|
|
12
|
+
`warning W1074: Unknown custom attribute`.
|
|
13
|
+
3. A UI do Swagger devolve **401**, ou o banner do console anuncia uma URL que não abre.
|
|
14
|
+
4. `E2003`/`E2066` em cascata no `.dpr` ao configurar `Swagger.Title(...)` ou `Horse.GBSwagger.Middleware`.
|
|
15
|
+
|
|
16
|
+
## Causa
|
|
17
|
+
|
|
18
|
+
1. A rota é `BasePath + SwagPath.Name + '/' + SwagEndPoint.Path` (`{id}` vira `:id`). `[SwagPath('Tag')]` (1
|
|
19
|
+
argumento) deixa `Name` vazio e a rota fica na raiz; `[SwagPath(C_Prefix, 'Tag')]` acrescenta o prefixo.
|
|
20
|
+
2. Os atributos `SwagPath`, `SwagGET`, `SwagPOST`, `SwagPUT`, `SwagDELETE` estão em `GBSwagger.Path.Attributes`, que
|
|
21
|
+
`Horse.GBSwagger` não reexporta. Sem a unit, o atributo é ignorado com um simples warning.
|
|
22
|
+
3. A UI fica em `/swagger/doc/html` e o JSON em `/swagger/doc/json`. `/swagger` não é rota: pular `'/swagger'` no
|
|
23
|
+
`SkipRoutes` não libera a UI.
|
|
24
|
+
4. `Title` e `Description` vivem em `IGBSwaggerInfo` (acesso por `.Info`, fechado com `.&End`), e o middleware é a
|
|
25
|
+
função `HorseSwagger`.
|
|
26
|
+
|
|
27
|
+
Sobre a ordem do JWT: `THorse.Use(...)` **sem path** registra no nó raiz e roda para toda rota, registrada antes ou
|
|
28
|
+
depois. Controllers que se registram na `initialization` (`THorseGBSwaggerRegister.RegisterPath`) continuam
|
|
29
|
+
protegidos pelo `Use(HorseJWT(...))` global. A ordem só importa para `Use` com path específico. O cadeado do Swagger
|
|
30
|
+
é documental (endpoints não públicos ganham o cadeado automaticamente; `[SwagGET('rota', 'desc', True)]` deixa
|
|
31
|
+
público); a proteção real é o middleware.
|
|
32
|
+
|
|
33
|
+
## Correção
|
|
34
|
+
|
|
35
|
+
- Ao converter controller que já atende na raiz, usar `[SwagPath('Tag')]` para preservar o caminho.
|
|
36
|
+
- `GBSwagger.Path.Attributes` no `uses` de todo controller anotado; tratar `W1074` como erro.
|
|
37
|
+
- `SkipRoutes` com `/swagger/doc/html` e `/swagger/doc/json`, e o banner anunciando `/swagger/doc/html`.
|
|
38
|
+
- Configuração pelo `.Info ... .&End` e `THorse.Use(HorseSwagger)`. `Version`, `BasePath`, `Host`, `AddSecurity`,
|
|
39
|
+
`AddBearerSecurity`, `Path` e `AddModel` ficam direto em `IGBSwagger`; `Swagger` é variável global da unit.
|
|
40
|
+
|
|
41
|
+
## Exemplo
|
|
42
|
+
|
|
43
|
+
```pascal
|
|
44
|
+
uses
|
|
45
|
+
Horse, Horse.GBSwagger, Horse.JWT, GBSwagger.Path.Attributes;
|
|
46
|
+
|
|
47
|
+
Swagger
|
|
48
|
+
.Info
|
|
49
|
+
.Title('MinhaApi')
|
|
50
|
+
.Description('API REST')
|
|
51
|
+
.Version('1.0.0')
|
|
52
|
+
.&End
|
|
53
|
+
.AddBearerSecurity;
|
|
54
|
+
|
|
55
|
+
THorse
|
|
56
|
+
.Use(HorseSwagger)
|
|
57
|
+
.Use(HorseJWT(LSegredo,
|
|
58
|
+
THorseJWTConfig.New.SkipRoutes(['/health', '/swagger/doc/html', '/swagger/doc/json'])));
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
Banner que não aparece em saída redirecionada: `console-writeln-sem-flush-nao-loga.md`.
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# `MSB6003` / `MSB6002` — linha de comando do compilador longa demais
|
|
2
|
+
|
|
3
|
+
## Sintoma
|
|
4
|
+
|
|
5
|
+
O build pelo msbuild falha com:
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
warning MSB6002: The command-line for the "DCC" task is too long. Command-lines longer than 32000 characters
|
|
9
|
+
error MSB6003: The specified task executable "dcc32.exe" could not be run. The filename or extension is too long
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
(em português: "O nome do arquivo ou a extensão é muito grande"). Costuma compilar no IDE e falhar na linha de
|
|
13
|
+
comando, principalmente em Android64/iOS e em máquinas com muitas bibliotecas de terceiros instaladas.
|
|
14
|
+
|
|
15
|
+
## Causa
|
|
16
|
+
|
|
17
|
+
O limite do `CreateProcess` do Windows é de cerca de 32.000 caracteres. `DCC_UnitSearchPath` inchado por bibliotecas
|
|
18
|
+
globais (TMS, ACBr, DevExpress...) e `DCC_UsePackage` expandido em flags de pacote fazem o comando do `dcc` passar
|
|
19
|
+
disso, às vezes de 50.000.
|
|
20
|
+
|
|
21
|
+
## Correção
|
|
22
|
+
|
|
23
|
+
1. **Preferida:** arquivo de resposta do compilador. Numa `PropertyGroup` base do `.dproj` (sem condição de
|
|
24
|
+
plataforma), acrescentar `DCC_ForceExecute`. O msbuild grava `<Projeto>.cmds` e passa só `@Projeto.cmds` ao `dcc`.
|
|
25
|
+
Não remove caminhos nem muda a estrutura do projeto.
|
|
26
|
+
2. Se ainda estourar ou não der para mexer no `.dproj`:
|
|
27
|
+
- encurtar `DCC_UnitSearchPath`, tirando caminhos de bibliotecas que o projeto não usa;
|
|
28
|
+
- concentrar os `.dcu` pré-compilados das bibliotecas num único diretório e referenciar só ele;
|
|
29
|
+
- usar caminhos curtos ou mapear a raiz das bibliotecas num drive (`subst`);
|
|
30
|
+
- chamar o `dcc32`/`dcc64` direto com um `<Projeto>.cfg` na pasta do projeto, que não tem limite de tamanho. Os
|
|
31
|
+
caminhos relativos do `.cfg` são resolvidos a partir da pasta corrente, então o `.bat` precisa de `cd /d` para a
|
|
32
|
+
pasta do projeto antes.
|
|
33
|
+
|
|
34
|
+
## Exemplo
|
|
35
|
+
|
|
36
|
+
```xml
|
|
37
|
+
<PropertyGroup>
|
|
38
|
+
<DCC_ForceExecute>true</DCC_ForceExecute>
|
|
39
|
+
</PropertyGroup>
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Formato do `.cfg` (alternativa do item 2):
|
|
43
|
+
|
|
44
|
+
```ini
|
|
45
|
+
-DDEBUG
|
|
46
|
+
-NSWinapi;System;Vcl;Data
|
|
47
|
+
-E".\bin"
|
|
48
|
+
-N0".\dcu"
|
|
49
|
+
-U"modules\horse\src"
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
Quem compila no Windows encontra o modelo de `.bat` com log em `build-via-bat-com-log.md`.
|