LogoLogo
  • Home
  • Projects
  • About
  • Contact

Asdoc GUI and CommandProxy

Devon O. · June 01, 2008 · AIR, Flash · 14 comments
3

This is something I’ve been wanting to do for quite some time.

Many moons ago, I created a simple GUI for asdoc.exe (the tool that creates nice looking HTML documentation from actionscript class files for those wondering – though I can’t imagine anyone reading this and not knowing) using SWFKit. Well, it was about the same time that Apollo first appeared (or maybe it was AIR beta 1 by that time – who can remember), and I thought it would be great to convert the whole project into an AIR application. It didn’t take long, though, to discover that AIR was not capable of launching applications in their native habitats, so that ended that. Then back in January, Mike Chambers published a means of integrating AIR with C-Sharp thereby gaining a closer OS relationship. This would let you do things like launch applications and take screen shots straight from AIR.

Finally, four and half months later, I got the time to “play around” and test out this intriguing proof of concept. And so enters ASDoc GUI version 2.0 – this time created in Flash/AIR but, thanks to CommandProxy, capable of launching asdoc.exe.

You can see some screenshots below.

You can download the project here, but because this was only a test of Mike Chambers’ concept, I didn’t bother building a custom installer and manual installation, while not wildly difficult, may be a bit tricky.

To install:

  1. Download the .zip file here and extract to wherever desired.
  2. Install the ASDocGUI.air file (requires latest version of AIR runtime to be installed), but don’t run it (well, you can go ahead and run it if you want to. It won’t break anything – but it won’t work, either).
  3. Navigate to the installation directory (on Windows that’s C:\Program Files\ASDocGUI by default) and drop in the GUILauncher.exe file. GUILauncher.exe and ASDocGUI.exe should reside in the same directory.
  4. Now simply run GUILauncher.exe – it will automatically launch the AIR application and you’re in business. If you desire a shortcut on your desktop (or anywhere else) make sure it’s a shortcut to GUILauncher.exe.

The above instructions also come in a readme.txt file included in the .zip.

A few things to consider:

This isn’t the prettiest application ever created. Because this was all just a test of Mike Chambers’ ideas I didn’t do much beautification. The design is simple as heck. The GUILauncher.exe will run at the same time as the AIR app. Don’t close it, it’s necessary and will also provide a little feedback about what’s going on inside a console window. Speaking of feedback, expect little to none. The application works fine when all goes well, but when it doesn’t go so well, it will fail silently. Make sure you know generally what you’re doing as far as asdoc commands and expectations are concerned. If I get a bit of positive feedback, I just may make a more user friendly version. It works fine for what I use it for, however, and it certainly served its purpose demonstrating the CommandProxy concept.

Speaking of which, the CommandProxy concept is, first of all, very simple to put into effect. I believe the largest amount of development time went into creating an Accordion component (which I will post at a later date after I clean up and better document the code as it’s now a part of my ui package). I see no reason why Adobe should not implement a similar .api in AIR itself in a later release. I understand that security is a concern, however, other .swf wrappers (Zinc, SWFKit, etc) have been doing these types of things for years. I see no reason why Adobe shouldn’t hop on board and really utilize it’s own technologies to the fullest extent.

By the way, if anyone tries this out with a MAC, please post a comment. I’m curious to hear the results.

For more information on the CommandProxy “Proof-of-Concept”, get it straight from the horse’s mouth.

  Facebook   Pinterest   Twitter   Google+
  • Yahtzee! Too Late for a Contest, but Never too Late to Play
    July 27, 2008 · 4 comments
    2132
    3
    Read more
  • Updates to fPlayer
    February 03, 2008 · 0 comments
    1559
    4
    Read more
  • UV Scrolling in Starling
    May 07, 2012 · 5 comments
    4874
    14
    Read more
14 Comments:
  1. “I see no reason why Adobe shouldn’t hop on board and really utilize it’s own technologies to the fullest extent.”

    There’s really one main reason they didn’t add this feature: They want to try and force people to make cross-platform AIR apps. By making it hard to call native code, they hope to encourage people to only use cross-platform SWF/HTML content. As you’ve noted, it’s not really a security concern, since AIR apps already have plenty of access to the filesystem and could easily cause all sorts of trouble as is.

    Personally I think it’s dumb to cripple a tool to enforce an ideology.

    David R · June 01, 2008
  2. That’s a good point, David R, and actually one I meant to bring up. I wouldn’t call it “dumb” to encourage cross platform development – it really is AIR’s biggest and best feature and is quite an achievment so far. However, they (the Adobe team) have already blurred the line a bit. For example, the NativeMenu object supports an Application menu (for Mac OS X) and a Window menu (for Windows) as well as a Dock icon (Mac) and System tray icon (windows). I think they could “easily” extend the File object’s api to include a launchNativeApplication() method that varies according to OS in a way similar to NativeMenu. Of course it could be argued this is a slippery slope and soon everyone would want all OS api’s exposed in some way, but I don’t think so. I believe that such base abilities as taking screen shots or launching native applications are at least as important as adding dock or system tray icons. But maybe that’s just me.

    Devon O. · June 02, 2008
  3. Devon, this looks great (why hasn’t Adobe provided an ASDoc GUI?), but your suggestion to try it on a Mac would be fruitless, since you provided an EXE file which would only run under Windows!

    Brett Walker · June 13, 2008
  4. We’ll just pretend I didn’t say that.. :)

    Devon O. · June 13, 2008
  5. Looks promiing, but I the GUILauncher.exe app fails to launch on XP for me..

    noponies · June 16, 2008
  6. I apologize for the difficulties, noponies. I created the whole thing on Win XP and it works fine for me. I can’t tell what the problem may be.

    Devon O. · June 18, 2008
  7. I was googling around for GUI tools and got two tools probably developed by you. Seems like you are the ASDocs guru.

    well none of the tools worked for me as I get this error.
    pnpDetails.mxml: Error: Unable to locate specified base class ‘view.panels.customPanel’ for component class ‘pnpDetails’

    I have a customPanel.mxml which is a customised panel and i am using it in other custom mxml components.

    my panels start like this

    ….
    ….

    do you think, that would be a problem. How do I solve this.

    Varun Shetty · July 08, 2008
  8. oops.. some tags jus disappeared

    Varun Shetty · July 08, 2008
  9. Hey, Varun.. Don’t know how I became an ASDoc guru and I’m honestly not sure if I could help out or not, but go over to the contact form at http://www.onebyonedesign.com/index2.html (“when” section) and drop me a direct line and we can try to figure out what’s happening..

    Devon O. · July 09, 2008
  10. Devon,

    I’m running XP via virtulisation, so thats prob why. In the end I just wrote an ant task for flex, works like a charm.

    Congrats on your guru status!

    noponies · August 11, 2008
  11. Wait a minute. I have guru status?
    Glad you got it working noponies…

    Devon O. · August 14, 2008
  12. Looks cool and I was looking forward to not having to type in the command line anymore – but, same problems as noponies. I’m running XP in Bootcamp on a Mac so guess this may have the same issue :-(

    oh well!

    Robert_t · February 12, 2009
  13. Very nice! :) I was hoping something like this was around.

    I’m currently using a plugin for FlashDevelop, but it doesn’t have as many options, and isn’t really all inclusive of the different options available in ASDoc, and instead you have to type those values in manually.

    Does this work with the newest release of ASDoc (currently in BETA)? I use that version because the current one does not support typed Vectors.

    Andreas Renberg · December 10, 2009

Leave a Comment! Cancel reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Devon O. Wolfgang

AIR | Unity3D | AR/VR

Unity Certified Developer

Technical Reviewer of “The Essential Guide to Flash CS4 AIR Development” and “Starling Game Development Essentials”

Reviewer of “The Starling Handbook”

Unity Engineer at Touch Press.

Categories
  • Actionscript (95)
  • AIR (16)
  • Flash (99)
  • Games (7)
  • Liberty (13)
  • Life (53)
  • Shaders (20)
  • Unity3D (21)
Recent Comments
  • MainDepth on Unity Ripple or Shock Wave Effect
  • Devon O. on Unity Ripple or Shock Wave Effect
  • Feral_Pug on Unity Ripple or Shock Wave Effect
  • bavvireal on Unity3D Endless Runner Part I – Curved Worlds
  • Danielius Vargonas on Custom Post Processing with the LWRP
Archives
  • December 2020 (1)
  • December 2019 (1)
  • September 2019 (1)
  • February 2019 (2)
  • December 2018 (1)
  • July 2018 (1)
  • June 2018 (1)
  • May 2018 (2)
  • January 2018 (1)
  • December 2017 (2)
  • October 2017 (1)
  • September 2017 (2)
  • January 2017 (1)
  • July 2016 (1)
  • December 2015 (2)
  • March 2015 (1)
  • September 2014 (1)
  • January 2014 (1)
  • August 2013 (1)
  • July 2013 (1)
  • May 2013 (1)
  • March 2013 (2)
  • December 2012 (1)
  • November 2012 (1)
  • September 2012 (3)
  • June 2012 (2)
  • May 2012 (1)
  • April 2012 (1)
  • December 2011 (2)
  • October 2011 (3)
  • September 2011 (1)
  • August 2011 (1)
  • July 2011 (1)
  • May 2011 (2)
  • April 2011 (2)
  • March 2011 (1)
  • February 2011 (1)
  • January 2011 (2)
  • December 2010 (3)
  • October 2010 (5)
  • September 2010 (1)
  • July 2010 (2)
  • May 2010 (5)
  • April 2010 (2)
  • March 2010 (7)
  • February 2010 (5)
  • January 2010 (5)
  • December 2009 (3)
  • November 2009 (1)
  • October 2009 (5)
  • September 2009 (5)
  • August 2009 (1)
  • July 2009 (1)
  • June 2009 (2)
  • May 2009 (6)
  • April 2009 (4)
  • March 2009 (2)
  • February 2009 (4)
  • January 2009 (1)
  • December 2008 (5)
  • November 2008 (2)
  • September 2008 (1)
  • August 2008 (6)
  • July 2008 (6)
  • June 2008 (9)
  • May 2008 (4)
  • April 2008 (3)
  • March 2008 (4)
  • February 2008 (9)
  • January 2008 (7)
  • December 2007 (6)
Copyright © 2021 Devon O. Wolfgang