encoding

Codificacao de Arquivos — Addon Studio 2.0

REGRA CRITICA — SEM EXCECOES

Todo arquivo .java, .xml, .kt e .properties em projetos Addon Studio deve ser salvo em ISO-8859-1 (Latin-1).

---

Por que ISO-8859-1

O servidor Sankhya (Wildfly legado) e o compilador de addons esperam Latin-1. Arquivo salvo em UTF-8 causa corrupção de acentos e falha silenciosa em runtime.

---

Regras

Tipo de arquivo	Regra
.java / .kt	Salvo em ISO-8859-1. Acentos diretamente no encoding ou escapados como é, ç etc.
.xml (datadictionary, dbscripts)	Salvo em ISO-8859-1. Cabecalho obrigatorio: <?xml version="1.0" encoding="ISO-8859-1" ?>
.properties	Salvo em ISO-8859-1 (formato historico do Java 8 para properties).

---

O problema com LLMs

LLMs geram arquivos em UTF-8 por padrao. Apos criar ou editar qualquer .java, .xml, .kt ou .properties, converta o encoding antes de usar.

Antes de converter, cheque o charset atual (file -i arquivo.java). So converta se o resultado for charset=utf-8. Arquivo ja em ISO-8859-1 reconvertido de "UTF-8" pode ter acentos corrompidos; e errors='ignore'/errors='replace' apagam ou trocam caracteres silenciosamente.

Mac / Linux — iconv (nativo, preferido)

Duas guardas são obrigatórias em toda conversão: charset atual (só converter UTF-8) e ausência de U+FFFD (ver Perda silenciosa de acento). Sem elas a conversão troca acento por ? sem avisar.

# Arquivo especifico — NUNCA use o mesmo arquivo como entrada e saida (trunca o arquivo!)
f=arquivo.java
if grep -qF "$(printf '\357\277\275')" "$f"; then
    echo "PERDA: U+FFFD em $f -- restaure via git antes de converter"
else
    case $(file -bi "$f") in *utf-8*)
        t=$(mktemp) && iconv -f UTF-8 -t ISO-8859-1 "$f" > "$t" && cat "$t" > "$f" && rm -f "$t" ;;
    esac
fi

# Todos os .java do projeto (idem para *.xml, *.kt e *.properties)
find . -name "*.java" -exec sh -c '
    grep -qF "$(printf "\357\277\275")" "$1" && { echo "PERDA: U+FFFD em $1"; exit 0; }
    case $(file -bi "$1") in *utf-8*)
        t=$(mktemp) && iconv -f UTF-8 -t ISO-8859-1 "$1" > "$t" && cat "$t" > "$1" && rm -f "$t" ;;
    esac' _ {} \;