ASDoc Vector Problem

[dareksob]

Hallo Leute,
versuche mein Framework (nextFramework.de) mit einer ordenlichen API Dokumentation auszustratten.

Leider bekomme ich beim Kompilieren immer ein Problem.

Problem
Text for return in nextFramework.drawing:nfDrawingOperator/getAdapters is not valid.
org.xml.sax.SAXParseException: Der Elementtyp „IDrawingAdapter“ muss durch das entsprechende End-Tag „</IDrawingAdapter>“ abgeschlossen werden.

Es liegt an der Zeile.
public function getAdapters():Vector.<IDrawingAdapter>

und genauer gesagt am Rückgabewert eines Vectors.
Vectors werden zwar unterstützt aber als Rückgabewert gibt es immer den Fehler.

Habt ihr ein Tip oder eine Idee wie ich es lösen kann?

[Omega Psi]

Welches SDK nutzt du und wie ist der target-player gesetzt?

[dareksob]

Ich nutze, Flex 4.51 SDK

hier die command line
C:\SDK\Flex\bin\asdoc.exe -main-title "API nextFramework" -source-path "E:\SDK\default" -doc-sources "E:\SDK\default\nextFramework" -output "E:\SDK\#nextFramework\documentation\nextFramework " -library-path "E:\SDK\lib\monsterdebugger\MonsterDebugger.sw c" -external-library-path "C:\SDK\Flex451\frameworks\libs\player\11.2\player global.swc"

[Omega Psi]

Ich würde fast vermuten, der target-player muss gesetzt werden.

[dareksob]

Nein, das kann nicht sein.
Durch de Zeile: -external-library-path "C:\SDK\Flex451\frameworks\libs\player\11.2\pl ayer global.swc" hab ich es schon angeben das er die akutelle 11.2 version nutzen soll.

Dazu meckert er nur bei Vector Rückgabewerte, sonst müsste er bei jeder Vector Angabe meckert und davon gibt es einige. Deswegen verstehe ich den Fehler nicht so richtig.

Kannst auch gerne mal es ausprobieren? Geht es dann bei dir?

Gibt es noch welche ideen?

Danke
Darek

[Omega Psi]

Du gibst nur den Pfad einer Library an, nicht aber die Ziel-Runtime. Mehr kann ich dazu gegenwärtig aber nicht sagen.

[dareksob]

Ich meine das ist es doch.

Ich finde im netz keine weitern infos dazu außer das:

Re: Targeting flash player 10 with ASDoc?
That fixed my problem. You need to include the swc that targets the flash player version that your program is intended to run on in order for ASDoc to run correctly.

In my case, in order for me to target the flash player 10 functionality of "FileReference" I needed to include the following line with my ASDoc comand line:


-external-library-path "C:/Program Files/Adobe/Flex Builder 3 Plug-in/sdks/3.2.0/frameworks/libs/player/10/playerglobal.swc"


Was muss ich den angeben?

Grüße

[Omega Psi]

-target-player=10.1.0

[dareksob]

leider auch nicht Lösung. Komisch das der Tag nicht dokumentiert ist.

[dareksob]

scheinbar hab ich es geschaft. Zwar zeigt er mit die Fehler an aber er compiliert die Dokumentation.

der tag -lenient hat geholfen.

Dazu hab ich jetzt es per configurations datei erstellt was deutlich einfacher.

<?xml version="1.0"?>
<flex-config xmlns="http://www.adobe.com/2006/flex-config">

<compiler>
<source-path>
<path-element>E:\SDK\default</path-element>
</source-path>
<library-path>
<path-element>C:\SDK\Flex451\frameworks\libs\player\11.2 \playerglobal.swc</path-element>
<path-element>E:\SDK\lib\monsterdebugger\MonsterDebugger .swc</path-element>
</library-path>
<warn-no-constructor>false</warn-no-constructor>
</compiler>
<lenient>true</lenient>

<main-title>nextFramework API</main-title>
<doc-sources>
<path-element>E:\SDK\default\nextFramework\drawing</path-element>
</doc-sources>
<output>E:\SDK\#nextFramework\documentation\nextFr amework</output>
</flex-config>

und die batch datei
@echo off
C:\SDK\Flex\bin\asdoc.exe -load-config nextFramework.conf.xml
pause

dazu hab ich zufällig ein tool gefunden was auch nicht schlecht ist (Air App)
asdocr
gskinner.com: gBlog: ASDocr Update for AIR 2 RC 1

@Omega Psi vielen dank für deine unterstützung