You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@flex.apache.org by bi...@apache.org on 2012/09/06 23:41:03 UTC

svn commit: r1381768 - in /incubator/flex/utilities/trunk/installer: ./ .actionScriptProperties .flexProperties .project README READme RELEASE_GUIDE build.properties build.xml

Author: bigosmallm
Date: Thu Sep  6 21:41:02 2012
New Revision: 1381768

URL: http://svn.apache.org/viewvc?rev=1381768&view=rev
Log:
Updated build.xml to incorporate feedback regarding readme clarity and rat.report issues.  

Added:
    incubator/flex/utilities/trunk/installer/READme
Removed:
    incubator/flex/utilities/trunk/installer/README
Modified:
    incubator/flex/utilities/trunk/installer/   (props changed)
    incubator/flex/utilities/trunk/installer/.actionScriptProperties
    incubator/flex/utilities/trunk/installer/.flexProperties
    incubator/flex/utilities/trunk/installer/.project
    incubator/flex/utilities/trunk/installer/RELEASE_GUIDE
    incubator/flex/utilities/trunk/installer/build.properties
    incubator/flex/utilities/trunk/installer/build.xml

Propchange: incubator/flex/utilities/trunk/installer/
------------------------------------------------------------------------------
--- svn:ignore (original)
+++ svn:ignore Thu Sep  6 21:41:02 2012
@@ -7,3 +7,4 @@ rat.report
 release
 rc1
 rc
+temp.12

Modified: incubator/flex/utilities/trunk/installer/.actionScriptProperties
URL: http://svn.apache.org/viewvc/incubator/flex/utilities/trunk/installer/.actionScriptProperties?rev=1381768&r1=1381767&r2=1381768&view=diff
==============================================================================
--- incubator/flex/utilities/trunk/installer/.actionScriptProperties (original)
+++ incubator/flex/utilities/trunk/installer/.actionScriptProperties Thu Sep  6 21:41:02 2012
@@ -1,4 +1,22 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!--
+
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+
+-->
 <actionScriptProperties analytics="false" mainApplicationPath="InstallApacheFlex.mxml" projectUUID="151f0ac8-8811-45cd-b935-d7c2b0949fa3" version="10">
   <compiler additionalCompilerArguments="-define=INSTALLER::buildNumber,3 -define=INSTALLER::releaseVersion,'0.8'" autoRSLOrdering="true" copyDependentFiles="true" flexSDK="Apache Flex 4.8.0" fteInMXComponents="false" generateAccessible="true" htmlExpressInstall="true" htmlGenerate="false" htmlHistoryManagement="false" htmlPlayerVersionCheck="true" includeNetmonSwc="false" outputFolderPath="bin-debug" removeUnusedRSL="true" sourceFolderPath="src" strict="true" targetPlayerVersion="0.0.0" useApolloConfig="true" useDebugRSLSwfs="true" verifyDigests="true" warn="true">
     <compilerSourcePath>

Modified: incubator/flex/utilities/trunk/installer/.flexProperties
URL: http://svn.apache.org/viewvc/incubator/flex/utilities/trunk/installer/.flexProperties?rev=1381768&r1=1381767&r2=1381768&view=diff
==============================================================================
--- incubator/flex/utilities/trunk/installer/.flexProperties (original)
+++ incubator/flex/utilities/trunk/installer/.flexProperties Thu Sep  6 21:41:02 2012
@@ -1,2 +1,20 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!--
+
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+
+-->
 <flexProperties enableServiceManager="false" flexServerFeatures="0" flexServerType="0" toolCompile="true" useServerFlexSDK="false" version="2"/>

Modified: incubator/flex/utilities/trunk/installer/.project
URL: http://svn.apache.org/viewvc/incubator/flex/utilities/trunk/installer/.project?rev=1381768&r1=1381767&r2=1381768&view=diff
==============================================================================
--- incubator/flex/utilities/trunk/installer/.project (original)
+++ incubator/flex/utilities/trunk/installer/.project Thu Sep  6 21:41:02 2012
@@ -1,4 +1,22 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+
+-->
 <projectDescription>
 	<name>installer</name>
 	<comment></comment>

Added: incubator/flex/utilities/trunk/installer/READme
URL: http://svn.apache.org/viewvc/incubator/flex/utilities/trunk/installer/READme?rev=1381768&view=auto
==============================================================================
--- incubator/flex/utilities/trunk/installer/READme (added)
+++ incubator/flex/utilities/trunk/installer/READme Thu Sep  6 21:41:02 2012
@@ -0,0 +1,73 @@
+<!--
+
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+-->
+
+==========================================================================================================================================================
+Overview:
+=========
+
+- The InstallApacheFlex AIR application is intended to provide an easy, single-click installation of the Apache Flex SDK and all its dependencies.  
+- This will make it suitable for working with IDEs such as Flash Builder, FDT, IntelliJ, FlashDevelop, etc.  
+	The downloaded dependencies include:
+	 - The AIR sdk (Windows vs. Mac) based on the current platform
+	 - FlashPlayerGlobal.swc
+	 - SwfObject
+	 - OSMF
+	 - TLF
+	 
+	Optionally, the application would download these files if the user explicitly agrees:
+	 - BlazeDS
+	 - FontSWF utility
+ 
+	All the file names and urls of the downloaded files are available in installer/src/sdk-installer-config.xml. 
+	When the dependencies file names or urls change in future, update the sdk-installer-config.xml to ensure that the application works correctly.  
+
+- The application uses http://incubator.apache.org/flex/single-mirror-url.cgi to determine the preferred mirror url to download Apache Flex SDK binary from.
+- Once the Apache Flex SDK binary file is downloaded, a MD5 has is generated from it.  This hash is compared with the hash from the Apache Flex SDK release site.  
+	If they match, we verify that the downloaded binary file is a valid Apache release and proceed to unzip the file.  
+- The AIR SDK will downloaded and the relevant files are copied to the required locations
+- The Flash player global swc files and the config files are placed in the required locations
+- Then the rest of the external dependencies and the optional files (if selected by user) are downloaded and copied into the appropriate locations.  
+
+==========================================================================================================================================================
+Prerequisites and dependencies:
+===============================
+
+1.  This project also needs the project 'common' that is in the source distribution.  Make sure that the 'common' project lives in the same directory as the 'installer' project is.  
+Just unzipping the source distribution would normally take care of this.  
+
+2.  Run: ant get-as3commons.swc
+This step downloads the required libraries and saves it in the libs directory
+
+3.  In Flash Builder, add a linked resource called: APACHE_FLEX_UTILITIES_ROOT and point it to the directory path where the projects: 'installer' and 'common' are located.  
+
+==========================================================================================================================================================
+How to build the installer using ANT (no Flash Builder or any other IDE required):
+===================================================================
+
+1.a  In the installer directory, run: ant build -DFLEX_HOME=/path/to/apache/flex/sdk -DAIR_HOME=/path/to/air/sdk
+or
+1.b  Define these as environment variables: FLEX_HOME (path to Flex SDK) and FLEX_HOME (path to AIR SDK)
+	Then run "ant run" in the installer directory.  
+or
+1.c  Open the build.properties file and edit these variables to point them to the correct directory paths: FLEX_HOME and FLEX_HOME
+	Then run "ant run" in the installer directory.  
+	
+2.  The intaller executable file created in the installer/release directory.  If you are on Windows, you will see an .exe file; if you are on Mac OS, you will see a .dmg file.  
+	A temporary digital signing certificate - temp.p12 will be created in the installer directory as well.  
+	The password for this file is available in the build.properties file (var: TEMP_PASS_CHANGE_THIS)
\ No newline at end of file

Modified: incubator/flex/utilities/trunk/installer/RELEASE_GUIDE
URL: http://svn.apache.org/viewvc/incubator/flex/utilities/trunk/installer/RELEASE_GUIDE?rev=1381768&r1=1381767&r2=1381768&view=diff
==============================================================================
--- incubator/flex/utilities/trunk/installer/RELEASE_GUIDE (original)
+++ incubator/flex/utilities/trunk/installer/RELEASE_GUIDE Thu Sep  6 21:41:02 2012
@@ -1,5 +1,21 @@
-Apache Flex
-Copyright 2012 The Apache Software Foundation
+<!--
+
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+-->
 
 Steps to follow in preparation for a release of InstallApacheFlex
 

Modified: incubator/flex/utilities/trunk/installer/build.properties
URL: http://svn.apache.org/viewvc/incubator/flex/utilities/trunk/installer/build.properties?rev=1381768&r1=1381767&r2=1381768&view=diff
==============================================================================
--- incubator/flex/utilities/trunk/installer/build.properties (original)
+++ incubator/flex/utilities/trunk/installer/build.properties Thu Sep  6 21:41:02 2012
@@ -49,7 +49,7 @@ COMMON_SOURCE_DIR=${COMMON_PROJECT_DIR}/
 DEBUG_FLAG=false
 TEMP_PASS_CHANGE_THIS=random123$%^
 
-#certificate
+#Certificate for release build.  Modify only when you are making a release build (See RELEASE_GUIDE first)
 STORETYPE=pkcs12
 RELEASE_KEYSTORE_FILE=C:/p/documents/certificates/installapacheflex_self.p12
 CERT_PASSWORD_FILE=C:/p/documents/certificates/installapacheflex.password

Modified: incubator/flex/utilities/trunk/installer/build.xml
URL: http://svn.apache.org/viewvc/incubator/flex/utilities/trunk/installer/build.xml?rev=1381768&r1=1381767&r2=1381768&view=diff
==============================================================================
--- incubator/flex/utilities/trunk/installer/build.xml (original)
+++ incubator/flex/utilities/trunk/installer/build.xml Thu Sep  6 21:41:02 2012
@@ -328,6 +328,7 @@
         </copy>
 		
 		<copy file="${basedir}/READme" todir="${RELEASE_DIR}"/>
+		<copy file="${basedir}/READme" todir="${BUILD_DIR}/temp"/>
 		
         <fixcrlf srcdir="${BUILD_DIR}/temp" eol="crlf" excludes="**/*.ttf,**/*.png"/>
 
@@ -389,14 +390,12 @@
                 <exclude name="build.number"/>
                 <exclude name="**/.actionScriptProperties"/>
                 <exclude name="**/.flexProperties"/>
+				<exclude name="**/.flexLibProperties"/>
                 <exclude name="**/.project"/>
                 <exclude name="**/.fxpProperties"/>
                 <exclude name="**/.settings/**"/>
                 <exclude name="rat.report"/>
             </fileset>
-            <fileset dir="${COMMON_SOURCE_DIR}">
-                <exclude name="**/Apache License Version 2.txt"/>
-            </fileset>
         </rat:report>
         
         <delete dir="${RELEASE_DIR}/temp" failOnError="false"/>