You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@flex.apache.org by ah...@apache.org on 2014/02/24 09:04:23 UTC
[2/3] git commit: [flex-utilities] [refs/heads/develop] - update
notice files
update notice files
Project: http://git-wip-us.apache.org/repos/asf/flex-utilities/repo
Commit: http://git-wip-us.apache.org/repos/asf/flex-utilities/commit/16181f82
Tree: http://git-wip-us.apache.org/repos/asf/flex-utilities/tree/16181f82
Diff: http://git-wip-us.apache.org/repos/asf/flex-utilities/diff/16181f82
Branch: refs/heads/develop
Commit: 16181f82bd53e19f2e31a58c3bf6bcf0278dbfa6
Parents: b05f752
Author: Alex Harui <ah...@apache.org>
Authored: Mon Feb 24 00:03:38 2014 -0800
Committer: Alex Harui <ah...@apache.org>
Committed: Mon Feb 24 00:03:38 2014 -0800
----------------------------------------------------------------------
installer/README | 65 ++++++++++++++++++++++++++++++--------------
installer/RELEASE_GUIDE | 8 +++---
installer/RELEASE_NOTES | 4 +++
3 files changed, 53 insertions(+), 24 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/flex-utilities/blob/16181f82/installer/README
----------------------------------------------------------------------
diff --git a/installer/README b/installer/README
index a404943..1cbd81c 100644
--- a/installer/README
+++ b/installer/README
@@ -21,7 +21,7 @@ limitations under the License.
Overview:
=========
-- The Apache Flex SDK Installer AIR application provides an easy, installation of the
+- The Apache Flex SDK Installer AIR application provides an easy installation of the
Apache Flex SDK and all its dependencies. This will make it suitable for working with
IDEs such as Adobe Flash Builder, FDT, IntelliJ IDEA, FlashDevelop, etc.
The application downloads the following dependencies:
@@ -33,26 +33,41 @@ Overview:
Optionally, the application will download these files if the user explicitly agrees to
the licensing terms:
- Adobe BlazeDS
- - Adobe embedded font support
+ - Adobe embedded font support
- All the file names and urls of the downloaded files are available in
- installer/src/installer/sdk-installer-config-3.0.xml.
- When the dependencies file names or urls change in future, update the
- sdk-installer-config-3.0.xml to ensure that the application works correctly.
+- The Apache Flex SDK Installer 3.0 adds the ability to install virtually anything that
+ can be installed via an Apache Ant script. The list of choices to install are
+ described in installer/src/installer/sdk-installer-config-4.0.xml and posted to
+ http://flex.apache.org/installer/sdk-installer-config-4.0.xml. By default, the
+ installer looks there to determine the list of choices. Once a selection is made,
+ the installer then looks in the folder of the install package for a -config.xml file
+ and if found, uses that to determine the set of licensing options that need to be
+ accepted before installing. The installer then uncompresses the install package and
+ looks for installer.xml and runs that script via an approximation of Apache Ant that
+ has been written in ActionScript. If the -config.xml file is not found, the Installer
+ assumes it is installing an older version of the Apache Flex SDK.
+
+- When installing an older version of the Apache Flex SDK, the installer
+ determines the file names and urls of the downloaded files from
+ installer/src/installer/sdk-installer-config-4.0.xml. When the dependencies file
+ names or urls change in future, update the sdk-installer-config-4.0.xml to ensure
+ that the application works correctly. For newer installs driven by Apache Ant
+ scripts, the file names and urls are determined by the script itself.
- The application uses http://flex.apache.org/single-mirror-url.cgi to determine
- the preferred mirror url to download the Apache Flex SDK binary from.
+ the preferred mirror url to use to download the binary package. Newer installs
+ that use Apache Ant scripts use their own logic to select dependencies from mirrors.
-- Once the Apache Flex SDK binary file is downloaded, a MD5 hash is generated for it.
+- Once the binary package is downloaded, a MD5 hash is generated for 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
+ If they match, we verify that the downloaded binary package is a valid Apache release and
proceed to unzip the file.
-- The Adobe AIR SDK will be downloaded and the relevant files are copied to the required
- locations.
+- If required, the Adobe AIR SDK will be downloaded and the relevant files are copied
+ to the required locations.
-- The Adobe Flash Player playerglobal.swc file and the config files are placed in the
- required locations.
+- If required, the Adobe Flash Player playerglobal.swc file 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.
@@ -77,11 +92,11 @@ How to build the installer using ANT (no Flash Builder or any other IDE required
==========================================================================================
1. Unzip the source distribution. You should see the 'installer' directory and the
- 'common' directory in the root.
+ 'common' and 'ant_on_air' directories in the root.
+
+2. In the ant_on_air directory, run:
+ ant [-DFLEX_HOME=/path/to/apache/flex/sdk] [-DAIR_HOME=/path/to/air/sdk]
-2. In the installer directory, run:
- ant build [-DFLEX_HOME=/path/to/apache/flex/sdk] [-DAIR_HOME=/path/to/air/sdk]
-
FLEX_HOME is the absolute path to the Apache Flex SDK
If you omit this argument, and the system environment variable, FLEX_HOME exists,
it is used. Otherwise, the FLEX_HOME_MAC or FLEX_HOME_WIN property in
@@ -92,7 +107,10 @@ How to build the installer using ANT (no Flash Builder or any other IDE required
it is used. Otherwise, the AIR_HOME_MAC or AIR_HOME_WIN property in
installer/build.properties is used.
-2. The installer executable file created in the installer/release directory. If you are
+3. In the installer directory, run:
+ ant build [-DFLEX_HOME=/path/to/apache/flex/sdk] [-DAIR_HOME=/path/to/air/sdk]
+
+4. The installer 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
@@ -103,7 +121,7 @@ How to set up the project for working with Adobe Flash Builder (or any other IDE
==========================================================================================
1. Unzip the source distribution. You should see the 'installer' directory and the
- 'common' directory in the root.
+ 'common' and 'ant_on_air' directories in the root.
2. In the installer directory run:
ant get-as3commons.swc
@@ -115,4 +133,11 @@ How to set up the project for working with Adobe Flash Builder (or any other IDE
and point it to the directory path where the 'installer' and 'common' directories are
located.
-4. In the installer project, add ${APACHE_FLEX_UTILITIES_ROOT}/common/src as a source path.
+4. In the installer project, add ${APACHE_FLEX_UTILITIES_ROOT}/common/src as a source path.
+
+5. In the installer project, add ${APACHE_FLEX_UTILITIES_ROOT}/ant_on_air/src as a source path.
+
+6. In the installer project, add ${APACHE_FLEX_UTILITIES_ROOT}/ant_on_air/external as a source path.
+
+7. In the installer project, add ${APACHE_FLEX_UTILITIES_ROOT}/ant_on_air/locale/{locale} as a source path.
+
http://git-wip-us.apache.org/repos/asf/flex-utilities/blob/16181f82/installer/RELEASE_GUIDE
----------------------------------------------------------------------
diff --git a/installer/RELEASE_GUIDE b/installer/RELEASE_GUIDE
index 2b7379b..a67db6f 100644
--- a/installer/RELEASE_GUIDE
+++ b/installer/RELEASE_GUIDE
@@ -27,8 +27,8 @@ Steps to follow in preparation for a release of InstallApacheFlex
2.b. If it is a minor release, run: ant update-version
-3. Open build.properties and update the following:
- - Modify the KEYSTORE_DIR and CERT_PASSWORD_DIR variables with the correct directory paths
+3. Create local.properties and add the following:
+ - Modify the RELEASE_KEYSTORE_FILE and CERT_PASSWORD_FILE variables with the correct file paths
(You need to obtain the installapacheflex_self.p12 file and its password from the previous
release manager for InstallApacheFlex)
@@ -41,7 +41,7 @@ Steps to follow in preparation for a release of InstallApacheFlex
This step
- downloads all the necessary files,
- - updates the version numbers in InstallApacheFlex-app.xml and sdk-installer-config-2.0.xml
+ - updates the version numbers in InstallApacheFlex-app.xml and sdk-installer-config-4.0.xml
- creates the .exe or .dmg file depending on the OS you are working on
- creates the source release files as a .zip file and a tar.gz file
- signs the artifacts to create corresponding .asc and .md5 files (assumes that you have a pgp
@@ -50,4 +50,4 @@ This step
5. Upload all the files under the /release directory to the following directory before calling a VOTE.
https://dist.apache.org/repos/dist/dev/flex/installer/{version}/{RCversion}/
-6. Check that your key is cntained in https://dist.apache.org/repos/dist/release/flex/KEYS if not add it.
+6. Check that your key is contained in https://dist.apache.org/repos/dist/release/flex/KEYS if not add it.
http://git-wip-us.apache.org/repos/asf/flex-utilities/blob/16181f82/installer/RELEASE_NOTES
----------------------------------------------------------------------
diff --git a/installer/RELEASE_NOTES b/installer/RELEASE_NOTES
index 35d9d1f..ff54a40 100644
--- a/installer/RELEASE_NOTES
+++ b/installer/RELEASE_NOTES
@@ -20,6 +20,10 @@ limitations under the License.
Apache Flex
Copyright 2013 The Apache Software Foundation
+Apache Flex SDK Installer 3.0
+1. Now uses external localized strings
+2. Added support for install scripts based on Apache Ant
+
Apache Flex SDK Installer 2.7
1. Added support for OSMF2.0 [http://blogs.adobe.com/osmf/2012/03/osmf-2-0-now-available.html]
From Apache Flex 4.11.0 onwards, support for OSMF2.0 has been added.