How to user asDoc generation support
I want to generate docs. How to user asDoc generation support?
Comments are currently closed for this discussion. You can start a new one.
Keyboard shortcuts
Generic
? | Show this help |
---|---|
ESC | Blurs the current field |
Comment Form
r | Focus the comment reply box |
---|---|
^ + ↩ | Submit the comment |
You can use Command ⌘
instead of Control ^
on Mac
Support Staff 1 Posted by Yennick Trevels on 06 Jun, 2012 06:30 AM
normally it should work by executing the "gradle asdoc" command. This will create a "doc" folder in your project.
2 Posted by cwocwo on 06 Jun, 2012 07:05 AM
Z:\flex\ark>gradle asdoc
FAILURE: Could not determine which tasks to execute.
What went wrong: Task 'asdoc' not found in root project 'ark'.
Try: Run gradle tasks to get a list of available tasks.
BUILD FAILED
Total time: 2.786 secs
Z:\flex\ark>
------------------------------------------------------------------------------------ Z:\flex\ark>gradle tasks
Dynamic properties are deprecated: http://gradle.org/docs/current/dsl/org.gradle.api.plugins.ExtraProp...
Deprecated dynamic property: "userName" on "Credentials [username: null]", value: "deployment".
Deprecated dynamic property "userName" created in multiple locations.
:tasks
All tasks runnable from root project
Build tasks
assemble - Assembles all Jar, War, Zip, and Tar archives.
clean - Deletes the build directory.
Help tasks
dependencies - Displays the dependencies of root project 'ark'.
help - Displays a help message
projects - Displays the sub-projects of root project 'ark'.
properties - Displays the properties of root project 'ark'.
tasks - Displays the tasks runnable from root project 'ark' (some of the displayed tasks may belong to subprojects).
Other tasks
build - Assembles and tests this project.
copyresources - copies the resources to the build directory
publish - Publish build artifacts to specified directory.
Rules
Pattern: build: Assembles the artifacts of a configuration.
Pattern: upload: Assembles and uploads the artifacts belonging to a configuration.
Pattern: clean: Cleans the output files of a task.
To see all tasks and more detail, run with --all.
BUILD SUCCESSFUL
Total time: 2.935 secs
Support Staff 3 Posted by Yennick Trevels on 06 Jun, 2012 07:14 AM
Can you run "gradle tasks --all", then it should give all the tasks (including those of the subprojects). The asdoc task only works on swc projects (or on their parent projects which should delegate the execution).
4 Posted by cwocwo on 06 Jun, 2012 07:17 AM
Z:\flex\ark>gradle tasks --all
Dynamic properties are deprecated: http://gradle.org/docs/current/dsl/org.gradle.api.plugins.ExtraProp...
Deprecated dynamic property: "userName" on "Credentials [username: null]", value: "deployment".
Deprecated dynamic property "userName" created in multiple locations.
:tasks
All tasks runnable from root project
Build tasks
assemble - Assembles all Jar, War, Zip, and Tar archives.
clean - Deletes the build directory.
Help tasks
dependencies - Displays the dependencies of root project 'ark'.
help - Displays a help message
projects - Displays the sub-projects of root project 'ark'.
properties - Displays the properties of root project 'ark'.
tasks - Displays the tasks runnable from root project 'ark' (some of the displayed tasks may belong to subprojects).
Other tasks
build - Assembles and tests this project.
copyresources - copies the resources to the build directory
publish - Publish build artifacts to specified directory.
Rules
Pattern: build: Assembles the artifacts of a configuration.
Pattern: upload: Assembles and uploads the artifacts belonging to a configuration.
Pattern: clean: Cleans the output files of a task.
BUILD SUCCESSFUL
Total time: 3.076 secs
Z:\flex\ark>
And the build.gradle file :
buildscript {
}
apply plugin: 'gradlefx'
version = '1.0-SNAPSHOT'
type = 'swc'
locales = ['en_US', 'zh_CN']
additionalCompilerOptions = [
]
repositories {
}
dependencies {
}
5 Posted by cwocwo on 06 Jun, 2012 07:30 AM
I use the version that you send me yestoday.
https://gradlefx.tenderapp.com/discussions/problems/26/assets/0393b...=
Support Staff 6 Posted by Yennick Trevels on 06 Jun, 2012 07:57 AM
Oww sorry, looks like I build from the wrong branch. I've attached a new build to this message.
7 Posted by cwocwo on 06 Jun, 2012 09:31 AM
Z:\flex\ark>gradle tasks --all --stacktrace
Dynamic properties are deprecated: http://gradle.org/docs/current/dsl/org.gradle.api.plugins.ExtraProp...
Deprecated dynamic property: "userName" on "Credentials [username: null]", value: "deployment".
Deprecated dynamic property "userName" created in multiple locations.
FAILURE: Build failed with an exception.
What went wrong: java.lang.NoClassDefFoundError: org.apache.commons.lang.StringUtils
Try: Run with --info or --debug option to get more log output.
Exception is: org.gradle.listener.ListenerNotificationException: Failed to notify project evaluation listener.
Caused by: org.codehaus.groovy.runtime.InvokerInvocationException: java.lang.NoClassDefFoundError: org.apache.commons.lang.StringUtils Caused by: java.lang.NoClassDefFoundError: org.apache.commons.lang.StringUtilsBUILD FAILED
Total time: 2.579 secs
====================================================== I need add common-lang to buildscript's repositories.
Support Staff 8 Posted by Yennick Trevels on 06 Jun, 2012 04:56 PM
k, apparently I have to provide you the pom for the GradleFx artifact, this contains the dependency to commons-lang. So deploy the GradleFx jar on your maven repository with the pom in attachment.
9 Posted by cwocwo on 07 Jun, 2012 12:56 AM
It works.
But, how to set asdoc's additionalASDocOptions property?
And, what options could be set?
10 Posted by cwocwo on 07 Jun, 2012 01:04 AM
I use it in this way :
asdoc.additionalASDocOptions = ['-keep-xml=true', '-skip-xsl=true']
Support Staff 11 Posted by Yennick Trevels on 07 Jun, 2012 05:49 AM
normally you shouldn't have to use these options because they will keep the intermediate xml, which is only useful when you want to embed the asdoc information into your swc (can be achieved by setting the fatSwc property to true which will automatically set these options and package the asdoc information into the swc).
12 Posted by cwocwo on 07 Jun, 2012 05:57 AM
Yes, it's easy to use.
Thanks.
Support Staff 13 Posted by Yennick Trevels on 07 Jun, 2012 06:27 AM
To answer your question on how to use the additionalASDocOptions property and what options can be set:
It's used exactly as you are using it, so you're on the right path ;)
You can provide it any options that are accepted by the asdoc tool, these options can be found here: http://help.adobe.com/en_US/flex/using/WSd0ded3821e0d52fe1e63e3d11c...
Support Staff 14 Posted by Yennick Trevels on 11 Jun, 2012 06:12 AM
GradleFx v0.5 is now officially released, so it's now available on Maven Central.
15 Posted by cwocwo on 11 Jun, 2012 09:26 AM
I will try it.
Yennick Trevels closed this discussion on 15 Aug, 2012 02:03 PM.