Metadados (ComicInfo.xml)

ComicInfo.xml é um padrão informal, usado por vários scanners e ferramentas de quadrinhos, para embutir metadados bibliográficos dentro do próprio arquivo compactado. Quando presente, o InkShelf lê e persiste esses dados — são eles que alimentam os resultados de Busca por título/série/autor/editora e os painéis de detalhe do Leitor HQ.

Onde existe suporte

Só em ZIP, RAR (RAR4) e RAR5 — os formatos de arquivo compactado. PDF nunca tem metadados extraídos (o formato não tem convenção equivalente reconhecida pelo app) e EPUB não passa por esse extrator — segue seu próprio caminho de metadados via OPF, tratado como parte do Leitor EPUB, não deste mecanismo.

Como o arquivo é localizado

Qualquer entrada dentro do arquivo compactado cujo nome (ignorando o caminho/pasta em que está e maiúsculas/minúsculas) seja exatamente ComicInfo.xml é aceita — não precisa estar na raiz do arquivo.

Campos extraídos

Título, série, número, escritor, desenhista (penciller), arte-finalista (artist), colorista, editora, ano e resumo — os mesmos dez campos persistidos como colunas em FileEntity (ver Modelo de Dados). Campos ausentes no XML ficam null; texto é normalizado (quebras de linha padronizadas, espaços nas bordas removidos) antes de salvar, e um valor que sobra vazio depois dessa limpeza é tratado como ausente, não como string vazia.

Se nenhum campo tiver algum valor depois de tudo isso, o resultado inteiro é descartado — o app não persiste um registro de metadados "vazio" só porque um arquivo ComicInfo.xml existia mas não tinha nada de útil dentro.

Reaproveita o mesmo cache de arquivo do leitor

A extração não abre o arquivo de origem de forma independente: usa o mesmo arquivo compactado em cache do Cache do leitor (criando-o se ainda não existir), em vez de copiar o arquivo original de novo só para ler um XML pequeno de dentro dele.