Problema de compilação do ASDoc nos Flex Library Projects

Colocado por DClick Team na(s) categoria(s): 1, 4, 6, Actionscript, Adobe, Air, AR, ASDoc, auto, BI, blog, botão, builder 4, class, demo, err, erro, error, flash, flash builder, Flash Builder 4, Flex, for, IE, if, image, int, library, mg, MXML, O, on, PDI, problema, processo, pt, RIA, Ria’s Geral, RoR, SDK, TAT, tool, Twitter, UI, uint, update, XML em 02 28th, 2011 | Sem comentários

Todos sabemos que com a vinda do Flash Builder 4 nós ganhamos o suporte a visualização do ASDoc, mas algo que deixou a desejar foi na criação de novas libs através do Flex Library Project pois não há como adicionar o conteúdo do ASDoc sem que haja a inclusão dos sources dentro da lib.

Essa situação não agrada muito quando o seu objetivo é distribuir uma biblioteca que tenha todo o suporte do ASDoc mas que não contenha os sources do seu projeto, visando manter a propriedade intelectual do que está sendo distribuído.

Reconhecido o erro, a Adobe liberou um Ant simples que você pode usar em seus Flex Library Projects.

O Ant faz as seguintes ações:
1. Compila o SWC.
2. Compila o ASDoc.
3. Adiciona ao SWC os novos xml/DITA gerados pelo ASDoc.

Entendido o problema, segue o Ant feito pela adobe com algumas modificações.
(Observem os comentários e não esqueça de substituir o CAMINHO_PARA_O_FLEXTASKS.JAR e o CAMINHO_PARA_A_SDK_DO_FLEX)

PLAIN TEXT

XML:

<?xml version=“1.0″?>
name=“DClick” default=“main” basedir=“.”>
?
? ?
? ? ? ? output=“${basedir}/tempDoc” lenient=“true” failonerror=“true” keep-xml=“true” skip-xsl=“true” fork=“true”>
? ? ? ?? ? ?.source-path path-element=“${basedir}/src”/>
? ? ? ? ? ? -sources path-element=“${basedir}/src”/>
? ? ? ? >
? ? ? ?
? ? ? ?
? ? ? ? destfile=“${basedir}/bin/${ant.project.name}.swc” update=“true”>
? ? ? ?? ? ? dir=“${basedir}/tempDoc/tempdita” prefix=“docs”>
? ? ? ? ? ?? ? ? name=“*.*”/>
? ? ? ? ? ? ? ? name=“ASDoc_Config.xml”/>
? ? ? ? ? ? ? ? name=“overviews.xml”/>
? ? ? ?? ? ?>
? ? ? ? >
? ? >
?
? ? name=“clean-temp-docs”>
? ? ? ? dir=“${basedir}/tempDoc” failonerror=“false” includeEmptyDirs=“true”/>
? ? >
?
>

Agora que já entendemos o problema e já temos a solução, que tal automatizar o processo? Vamos adicionar o Ant no processo automático de compilação do projeto.

1. Adicione o ant dentro do path do seu projeto.

2. Acesse as propriedades do projeto e vá em Builders.