name: diagnostico-f2613-package
description: Diagnostica e corrige erro F2613 (unit not found) em packages Delphi, com foco em dproj, dpr, nsproj, DCC_UnitSearchPath e dependencias reais. Use quando um package novo ou recem-extraido falhar por unit nao encontrada.
Diagnostico F2613 Package
Use esta skill quando o erro principal de build for error F2613: Unit '<nome>' not found em package Delphi.
Fluxo
- Identificar o primeiro
F2613do log (nao tratar mensagens em cascata antes dele). - Localizar o arquivo fisico da unit faltante no workspace.
- Validar o
.dprojdo package que falhou:DCC_UnitSearchPathcontem a pasta correta da unit?- existe caminho quebrado por nivel relativo errado?
- Aplicar correcao minima no package:
- preferir ajustar
DCC_UnitSearchPathcom pasta-base estavel - adicionar
DCCReferenceapenas quando necessario para design-time/compilacao direta
- preferir ajustar
- Revisar o
.dprdo package para confirmar se as units do modulo principal continuam coerentes. - Validar
nsproj.xmlsomente para ordem de build entre packages (nao usar como substituto de search path). - Reexecutar build apenas do package afetado.
- Se surgir novo
F2613, repetir do passo 1 (cadeia controlada, uma causa por vez).
Regras de decisao
- Corrigir primeiro no package que falhou, nao no executavel principal.
- Nao espalhar dezenas de paths no
DCC_UnitSearchPath; adicionar somente o necessario. - Se a correcao exigir muitos caminhos, parar e discutir extracao de dependencia para package proprio.
- Diferenciar papeis:
nsproj.xml: ordem de build/dependencia entre projetosdproj: visibilidade de unit para o compiladordpr: unidade compilada diretamente no projeto/package
- Em erro com
nsbuild.jarnao encontrado, executarnsbuild.batno diretoriobuild.
Saida minima
- Primeiro
F2613identificado. - Unit faltante e caminho real encontrado.
- Arquivo(s) corrigido(s) (
.dproj, opcionalmente.dpr/.nsproj). - Resultado do build do package apos ajuste.