airake 0.1.9 → 0.1.10

data/History.txt

@@ -1,3 +1,11 @@
+== 0.1.10 2007-10-01
+
+* Moving fcsh tasks into own namespace. New tasks names are: fcsh:start, fcsh:stop, fcsh:restart
+* DEBUG=true is enabled by default for test and adl tasks
+* Updated to use AIR beta 2
+* Updated documentation
+* Removed fail message on mxmlc
+
 == 0.1.9 2007-09-06
 
 * Updating documentation

data/Manifest.txt

@@ -24,7 +24,9 @@ lib/airake/fcsh.rb
 lib/airake/fcshd.rb
 lib/airake/project.rb
 lib/airake/tasks.rb
+lib/airake/tasks/air.rake
 lib/airake/tasks/deployment.rake
+lib/airake/tasks/fcsh.rake
 lib/airake/version.rb
 log/debug.log
 script/destroy

data/README.txt

@@ -2,14 +2,13 @@
 
 Flex SDK: http://labs.adobe.com/technologies/flex/sdk/flex3sdk.html
 
-To include mxmlc, fcsh, adl and adt (from Flex SDK):
+To include mxmlc and fcsh (from Flex SDK):
   export PATH="/path/to/flex_sdk_3/bin"
   
-Apollo SDK: http://labs.adobe.com/downloads/airsdk.html
-(Note: flex 3 beta 1 includes these files already)
+AIR SDK: http://labs.adobe.com/downloads/airsdk.html
 
-To include adl and adt (from Apollo SDK):
-  export PATH="/Applications/ApolloSDK/bin:$PATH"
+To include adl and adt (from AIR SDK):
+  export PATH="/path/to/air_sdk/bin:$PATH"
   
 == Creating an AIR project
 
@@ -27,25 +26,31 @@ To include adl and adt (from Apollo SDK):
   rake air:adl 
   
   # Start FCSHD (for faster compilation)
-  rake air:start_fcshd
+  rake fcsh:start
 
   # Stop FCSHD
-  rake air:stop_fcsh
+  rake fcsh:stop 
 
   # Restart FCSHD
-  rake air:restart_fcshd
+  rake fcsh:restart 
 
-  # Running alternate MXML, (the following expects src/Test-app.xml descriptor file)
+  # Running alternate MXML, (we expect src/Test-app.xml descriptor)
   rake air:adl MXML=src/Test.mxml
 
-  # Run ADL with debug enabled
-  rake air:adl DEBUG=true
+  # Run ADL with debug disabled
+  rake air:adl DEBUG=false
 
   # Testing
   rake air:test
 
   # Package AIR file
   rake air:package
+
+== Deprecated tasks
+
+Renamed air:start_fcshd to fcsh:start
+Renamed air:stop_fcshd to fcsh:stop
+Renamed air:restart_fcshd to fcsh:restart
   
 == Adding other tasks
 

data/app_generators/airake/templates/README

@@ -2,46 +2,51 @@
 
 Flex SDK: http://labs.adobe.com/technologies/flex/sdk/flex3sdk.html
 
-To include mxmlc, fcsh, adl and adt (from Flex SDK):
+To include mxmlc and fcsh (from Flex SDK):
   export PATH="/path/to/flex_sdk_3/bin"
   
-Apollo SDK: http://labs.adobe.com/downloads/airsdk.html
-(Note: flex 3 beta 1 includes these files already)
+AIR SDK: http://labs.adobe.com/downloads/airsdk.html
 
-To include adl and adt (from Apollo SDK):
-  export PATH="/Applications/ApolloSDK/bin:$PATH"
+To include adl and adt (from AIR SDK):
+  export PATH="/path/to/air_sdk/bin:$PATH"
     
 == Tasks
 
   # View all tasks
-  rake --tasks 
+  rake --tasks
 
   # Compiling
   rake air:compile 
 
   # Running air debug launcher (ADL)
   rake air:adl 
-  
+
   # Start FCSHD (for faster compilation)
-  rake air:start_fcshd
+  rake fcsh:start
 
   # Stop FCSHD
-  rake air:stop_fcsh
+  rake fcsh:stop 
 
   # Restart FCSHD
-  rake air:restart_fcshd
+  rake fcsh:restart 
 
-  # Running alternate MXML, (the following expects src/Test-app.xml descriptor file)
+  # Running alternate MXML, (we expect src/Test-app.xml descriptor)
   rake air:adl MXML=src/Test.mxml
 
-  # Run ADL with debug enabled
-  rake air:adl DEBUG=true
+  # Run ADL with debug disabled
+  rake air:adl DEBUG=false
 
   # Testing
   rake air:test
 
   # Package AIR file
   rake air:package
+
+== Deprecated tasks
+
+Renamed air:start_fcshd to fcsh:start
+Renamed air:stop_fcshd to fcsh:stop
+Renamed air:restart_fcshd to fcsh:restart
   
 == Adding other tasks
 

data/app_generators/airake/templates/application.mxml

@@ -1,12 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <mx:WindowedApplication xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute" title="<%= app_name %>">  
 
-  <mx:Style>
-    Application {
-      background-image:"";
-      background-color:"";
-      background-alpha:"0.5";
-    }
-  </mx:Style>
+  <mx:Label text="Hi"/>
 
 </mx:WindowedApplication>

data/app_generators/airake/templates/descriptor.xml

@@ -1,29 +1,33 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<application xmlns="http://ns.adobe.com/air/application/1.0.M4" appId="com.company.App" version="0.0.1">
-
-<!-- 
-    AIR Application Descriptor File: 
-    Specifies parameters for identifying, installing, and launching AIR applications.
-
-    The root element of the descriptor is "application" and has the attributes:
-    appID   - A string identifying this application. Every AIR application must
-              have a unique appID. The recommended form of an appID is a 
-              dot-delimited, reverse-DNS-style string, such as 
-              "com.example.ApplicationName". The appID string must be between 
-              17-255 characters long and may include the following characters:
-              0-9 
-              a-z 
-              A-Z 
-              . (dot)
-              - (hyphen)              
-    version - An application-defined version designator.
-              Examples: "1.0", ".4", "0.5", "Alpha 1",
-    xmlns   - The AIR namespace ("http://ns.adobe.com/air/application/1.0.M4").
--->
+<application xmlns="http://ns.adobe.com/air/application/1.0.M5" appId="com.companyName.<%= app_name %>" version="0.0.1">
+
+  <!-- 
+      AIR Application Descriptor File: 
+      Specifies parameters for identifying, installing, and launching AIR applications.
+
+      The root element of the descriptor, "application" has these attributes:
+      appID             - A string identifying this application. Every AIR 
+                          application must have a unique appID. The recommended 
+                          form of an appID is a dot-delimited, reverse-DNS-style 
+                          string, such as: "com.example.ApplicationName"
+                          The appID string must be between 17-255 characters long
+                          and may include the following characters:
+                          0-9 
+                          a-z 
+                          A-Z 
+                          . (dot)
+                          - (hyphen)              
+      version           - An application version designator.
+                          Examples: "1.0", ".4", "0.5", "Alpha 1"
+      minimumPatchLevel - the minimum patch level of the runtime version that this 
+                          application requires. Example: 45
+      xmlns             - The AIR namespace: http://ns.adobe.com/air/application/1.0.M5 
+                          The last segment of the namespace specifies the version 
+                          of the runtime required for this application to run.
+  -->
     
     <!--
-        The name displayed by the operating system when the application is 
-        running. (Required.)
+        The application name displayed by the operating system. (Required.)
     -->
     <name><%= app_name %></name>
     
@@ -43,72 +47,146 @@
     <copyright><%= Date.today.year %></copyright>
     
     <!--
-        The main content file of the application, which must be a SWF or 
-        HTML file. (Required.)
-        
-        Attributes:
-        systemChrome - "standard" or "none". If "standard", the application 
-                       window is opened with operating system-specific window 
-                       elements such as a title bar, minimize, and close 
-                       buttons. If "none", the application must provide its 
-                       own window controls. (Note, the Flex WindowedApplication 
-                       class supplies a set of window controls, which are only 
-                       shown when systemChrome="none".)
-        transparent  - "true" or "false". If "true", the application has support 
-                       for full transparency.
-        visible      - "true" or "false". If "false", the main window will not 
-                       be displayed 
-                       until the application changes the window visible property 
-                       to "true".
-        width        - the initial window height (including chrome).
-        height       - the initial window width (including chrome).
-        
-        In Flex Builder, the SWF reference required within this tag will be set 
-        automatically when you launch or export this application.
-    -->    
-    <rootContent systemChrome="none" transparent="true" visible="true" width="800" height="600">bin/<%= app_name %>.swf</rootContent>
-    
+        The settings for the initial application window.
+    -->
+    <initialWindow>
+      <!--
+          The title displayed in the AIR application installer.
+      -->
+      <title></title>
+
+      <!--
+          The main content file of the application, which must be a SWF or HTML 
+          file. (Required.)
+
+          Note: In Flex Builder, the SWF reference required within this tag will  
+          be set automatically when you launch or export this application.
+      -->
+      <content>bin/<%= app_name %>.swf</content>
+
+      <!--
+          Specifies the type of system chrome used by the window.
+
+              standard - the application window is opened with standard operating  
+                         system window elements such as a title bar, minimize, 
+                         and close buttons. 
+              none     - the application must provide its own window controls. 
+                         (Note, that the Flex mx:WindowedApplication class supplies 
+                         its own window controls, shown only when systemChrome=none.)
+
+          Default value: standard        
+       -->
+      <systemChrome>standard</systemChrome>
+
+      <!--
+          Specifies whether the window supports transparency and alpha blending 
+          against the desktop.
+
+          If true, the window display is composited against the desktop. Areas of 
+          the window not covered by a display object, or covered by display 
+          objects with an alpha setting of zero, are effectively invisible and 
+          will not intercept mouse events (which will be received by the desktop 
+          object below the window).
+
+          Setting transparent=true for a window with system chrome is not supported.
+
+          Default value: false
+      -->
+      <transparent>false</transparent>
+
+      <!--
+          Specifies whether the window will be visible on application startup.
+
+          If false, the main window will not be displayed until the application 
+          changes the NativeWindow.visible property to true or calls 
+          NativeWindow.activate(). Note that the Flex Framework will set the
+          initial window defined by mx:WindowedApplication to be visible  
+          immediately prior to the applicationComplete event unless the 
+          WindowedApplication.windowVisible property is false.
+
+          Default value: false
+      -->
+      <visible>true</visible>
+
+      <!-- 
+          Other settings for the initial window.
+      -->
+      <!--  <minimizable>true</minimizable> -->
+      <!--  <maximizable>true</maximizable> -->
+      <!--  <resizable>true</resizable> -->
+      <!--  <width>500</width> -->
+      <!--  <height>500</height> -->
+      <!--  <x>150</x> -->
+      <!--  <y>150</y> -->
+      <x>100</x>
+      <y>100</y>
+      <width>600</width>
+      <height>400</height>
+      <!-- <minSize>300 300</minSize> -->
+      <!--  <maxSize>800 800</maxSize> -->
+    </initialWindow>
+
     <!--
         The subdirectory within the default application installation location in 
         which to install the application.
+
+        Use forward slashes '/' to separate folders. The path cannot start with a 
+        forward slash; end with a dot '.'; and cannot contain the characters: *":<>?\| 
     -->
     <!-- <installFolder></installFolder> -->
-    
+
+    <!--
+        The location within the Windows Programs menu in which to place 
+        application shortcuts. Ignored on Mac OS X.
+
+        Use forward slashes '/' to separate folders. The path cannot start with a 
+        forward slash; end with a dot '.'; and cannot contain the characters: *":<>?\| 
+    -->
+    <!-- <programMenuFolder>Example Company/Example Application</programMenuFolder> -->
+
     <!--
         One or more PNG, GIF, or JPEG graphics files to be used as application 
         icons. The path specified is relative to the application root directory. 
-        If an image is specified, it must be the exact size. The image files 
-        must be included in the AIR package.
+        If an image is specified, it must be the exact size. The image files must 
+        be included in the AIR file.
     -->
-	
-	<!--
-        <icon>
-            <image16x16>icons/AIRApp_16.png</image16x16>     
-            <image32x32>icons/AIRApp_32.png</image32x32>   
-            <image48x48>icons/AIRApp_48.png</image48x48>    
-            <image128x128>icons/AIRApp_128.png</image128x128>
-        </icon>
-    -->
-	
+    <icon>
+        <!-- <image16x16>icons/AIRApp_16.png</image16x16> -->      
+        <!-- <image32x32>icons/AIRApp_32.png</image32x32> -->      
+        <!-- <image48x48>icons/AIRApp_48.png</image48x48> -->      
+        <!-- <image128x128>icons/AIRApp_128.png</image128x128> -->
+    </icon>
+
     <!-- 
         If the handleUpdates element is present in the application descriptor, 
         then the AIR runtime will defer version updates to this application.
     -->
     <!-- <handleUpdates/> -->
-    
+
     <!--
-        One or more file types to register when this application is installed.
-    -->  
-	
-	<!--  
-        <fileTypes>
+        Defines the file types for which this application may register.
+
+        Use the Shell object file registration methods  at run-time to set an  
+        application as the default application for a file type.
+
+        Icons are optional. If used, the path specified is relative to the 
+        application root directory. The icon files must be included in the AIR
+        file.
+    -->    
+    <fileTypes>
+        <!--
             <fileType>
                 <name>com.example</name>
                 <extension>xmpl</extension>
                 <description>Example file</description>
                 <contentType>example/x-data-type</contentType>
+                  <icon>
+                    <image16x16>icons/AIRApp_16.png</image16x16>      
+                    <image32x32>icons/AIRApp_32.png</image32x32>      
+                    <image48x48>icons/AIRApp_48.png</image48x48>     
+                    <image128x128>icons/AIRApp_128.png</image128x128>
+                  </icon>
             </fileType>
-        </fileTypes>
-    -->
-	
+        -->
+    </fileTypes>
 </application>

data/lib/airake/project.rb

@@ -144,14 +144,14 @@ module Airake
         
         The '#{cmd.split.first}' command failed to run. This could be because this executable isn't in the path.
         
-        To include mxmlc, adl and adt (from Flex Builder):
-          export PATH="/Applications/Adobe Flex Builder 3/sdks/moxie/bin:$PATH"
+        To include mxmlc and fcsh:
+          export PATH="/path_to/flex3sdk_b2_100107/bin:$PATH"
           
-        To include adl and adt (from Apollo SDK):
-          export PATH="/Applications/ApolloSDK/bin:$PATH"
+        To include adl and adt (from AIR SDK):
+          export PATH="/path_to/air_sdk/bin:$PATH"
         
       EOS
-      puts fail_message if error_status != 256 && error_status != 4096
+      #puts fail_message if error_status != 256 && error_status != 4096
       raise "[#{error_status}] Failed to run command: #{cmd}"
     end
 

data/lib/airake/tasks/air.rake

@@ -0,0 +1,39 @@
+namespace :air do
+    
+  desc "Compile"
+  task :compile do
+    begin
+      project = Airake::Project.new_from_rake(ENV)
+      fcsh = PatternPark::FCSH.new_from_rake(ENV)
+      fcsh.execute([ project.base_dir, project.mxmlc_command ])      
+    rescue PatternPark::FCSHConnectError => e
+      puts "Cannot connect to FCSHD (start by running: rake air:fcshd); Continuing compilation..."
+      project.run_mxmlc
+    end
+  end
+
+  desc "Test"
+  task :test do
+    ENV["DEBUG"] = "true" unless ENV.has_key?("DEBUG")
+    test_project = Airake::Project.new_from_rake(ENV, true)
+    test_project.run_mxmlc
+    test_project.run_adl
+  end
+
+  desc "Package"
+  task :package => :compile do
+    project = Airake::Project.new_from_rake(ENV)
+    project.run_adt
+  end
+  
+  task :set_debug do
+    ENV["DEBUG"] = "true" unless ENV.has_key?("DEBUG")
+  end
+
+  desc "Apollo Debug Luncher"
+  task :adl => [ :set_debug, :compile ] do    
+    project = Airake::Project.new_from_rake(ENV)
+    project.run_adl
+  end
+  
+end

data/lib/airake/tasks/deployment.rake

@@ -1,37 +1,8 @@
+# Deprecated
+# See fsch.rake
 namespace :air do
     
-  desc "Compile"
-  task :compile do
-    begin
-      project = Airake::Project.new_from_rake(ENV)
-      fcsh = PatternPark::FCSH.new_from_rake(ENV)
-      fcsh.execute([ project.base_dir, project.mxmlc_command ])      
-    rescue PatternPark::FCSHConnectError => e
-      puts "Cannot connect to FCSHD (start by running: rake air:fcshd); Continuing compilation..."
-      project.run_mxmlc
-    end
-  end
-
-  desc "Test"
-  task :test do
-    test_project = Airake::Project.new_from_rake(ENV, true)
-    test_project.run_mxmlc
-    test_project.run_adl
-  end
-
-  desc "Package"
-  task :package => :compile do
-    project = Airake::Project.new_from_rake(ENV)
-    project.run_adt
-  end
-
-  desc "Apollo Debug Luncher"
-  task :adl => :compile do
-    project = Airake::Project.new_from_rake(ENV)
-    project.run_adl
-  end
-
-  desc "Start the FCSHD process (or use air:fcshd)"
+  desc "Start the FCSHD process (DEPRECATED)"
   task :start_fcshd do  
     puts "Starting FCSHD..."
     PatternPark::FCSHD.start_from_rake(ENV)
@@ -39,7 +10,7 @@ namespace :air do
     
   task :fcshd => :start_fcshd # Alias
 
-  desc "Stop the FCSHD process"
+  desc "Stop the FCSHD process (DEPRECATED)"
   task :stop_fcshd do
     begin
       fcsh = PatternPark::FCSH.new_from_rake(ENV)
@@ -49,7 +20,7 @@ namespace :air do
     end
   end
 
-  desc "Restart the FCSHD process"
+  desc "Restart the FCSHD process (DEPRECATED)"
   task :restart_fcshd => [ :stop_fcshd, :sleep, :start_fcshd ]
   
   task :sleep do

data/lib/airake/tasks/fcsh.rake

@@ -0,0 +1,26 @@
+namespace :fcsh do
+
+  desc "Start the FCSHD process (or use air:fcshd)"
+  task :start do  
+    puts "Starting FCSHD..."
+    PatternPark::FCSHD.start_from_rake(ENV)
+  end
+    
+  desc "Stop the FCSHD process"
+  task :stop do
+    begin
+      fcsh = PatternPark::FCSH.new_from_rake(ENV)
+      fcsh.stop
+    rescue
+      puts "Could not stop FCSHD"
+    end
+  end
+
+  desc "Restart the FCSHD process"
+  task :restart => [ :stop, :sleep, :start ]
+  
+  task :sleep do
+    sleep 2
+  end
+  
+end

data/lib/airake/version.rb

@@ -2,7 +2,7 @@ module Airake #:nodoc:
   module VERSION #:nodoc:
     MAJOR = 0
     MINOR = 1
-    TINY  = 9
+    TINY  = 10
 
     STRING = [MAJOR, MINOR, TINY].join('.')
   end

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.4
 specification_version: 1
 name: airake
 version: !ruby/object:Gem::Version 
-  version: 0.1.9
-date: 2007-09-07 00:00:00 -04:00
+  version: 0.1.10
+date: 2007-10-01 00:00:00 -04:00
 summary: Adobe AIR tasks
 require_paths: 
 - lib
@@ -55,7 +55,9 @@ files:
 - lib/airake/fcshd.rb
 - lib/airake/project.rb
 - lib/airake/tasks.rb
+- lib/airake/tasks/air.rake
 - lib/airake/tasks/deployment.rake
+- lib/airake/tasks/fcsh.rake
 - lib/airake/version.rb
 - log/debug.log
 - script/destroy