You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@flex.apache.org by jo...@apache.org on 2023/02/20 22:20:28 UTC
svn commit: r60227 - in /release/flex/flex-maven-tools/flex-sdk-converter: 1.0.0/ 1.1.0/
Author: joshtynjala
Date: Mon Feb 20 22:20:28 2023
New Revision: 60227
Log:
flex-maven-tools/flex-sdk-converter 1.1.0
Added:
release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/
release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/README.txt
release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/RELEASE_NOTES
release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/apache-flex-sdk-converter-1.1.0-source-release.zip (with props)
release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/apache-flex-sdk-converter-1.1.0-source-release.zip.asc
release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/apache-flex-sdk-converter-1.1.0-source-release.zip.sha512
Removed:
release/flex/flex-maven-tools/flex-sdk-converter/1.0.0/
Added: release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/README.txt
==============================================================================
--- release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/README.txt (added)
+++ release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/README.txt Mon Feb 20 22:20:28 2023
@@ -0,0 +1,222 @@
+Apache Flex SDK Converter
+=========================
+
+ The Apache Flex SDK Converter tool is used to convert the Apache and Adobe
+ Flex SDKs and Air SDKs into Maven artifacts. Automatically creating the
+ Directories, pom-files, copying and moving the resources to the correct
+ destinations.
+
+ These artifacts can be used in Maven builds using the Flexmojos plugin
+ (Starting with version 6.x).
+
+ The Apache Flex SDK Converter comes with all the means to download, convert
+ and deploy a mavenized form of an Apache Flex SDK.
+
+ The Converter does not simply copy all java libraries to the destination; it checks
+ if the given artifact has already been deployed to Maven Central or by deploying an
+ other FDK previously. For this check you do need an internet connection to do the
+ conversion, otherwise it will probably take forever.
+
+ Internally it consists of 3 components:
+ - One Retriever
+ - DownloadRetriever: For downloading binary artifacts
+ - Four Converters
+ - One for producing the Apache Flex SDK artifacts
+ - One for producing the Adobe Flash artifacts
+ - One for producing the Adobe Air artifacts
+ - One for producing the Adobe Fontkit artifacts
+ - Two Deployers
+ - One using Aether with no requirement to Maven (Faster, but less configurable)
+ - One using a local Maven installation (A lot slower, but fully configurable)
+
+
+
+Getting the latest sources via git
+==================================
+
+ Getting the source code is the recommended way to get the Apache Flex SDK
+ Converter.
+
+ You can always checkout the latest source via git using the following
+ command:
+
+ git clone https://git-wip-us.apache.org/repos/asf/flex-utilities.git flex-utilities
+ cd flex-utilities/flex-maven-tools/flex-sdk-converter
+ git checkout develop
+
+Building the Apache Flex SDK Converter
+======================================
+
+ The Apache Flex SDK Converter is a relatively simple project. It requires some
+ build tools which must be installed prior to building the compiler and it depends
+ on some external software which are downloaded as part of the build process.
+ Some of these have different licenses. See the Software Dependencies section
+ for more information on the external software dependencies.
+
+Install Prerequisites
+---------------------
+
+ Before building the Apache Flex Compiler you must install the following software
+ and set the corresponding environment variables using absolute file paths.
+ Relative file paths will result in build errors.
+
+ ==================================================================================
+ SOFTWARE ENVIRONMENT VARIABLE (absolute paths)
+ ==================================================================================
+
+ Java SDK 1.7 or greater but smaller than 12 (*1) JAVA_HOME
+
+ Maven 3.1.0 or greater (*1) MAVEN_HOME
+
+ ==================================================================================
+
+ *1) The bin directories for MAVEN_HOME and JAVA_HOME should be added to your
+ PATH.
+
+ On Windows, set PATH to
+
+ PATH=%PATH%;%MAVEN_HOME%\bin;%JAVA_HOME%\bin
+
+ On the Mac (bash), set PATH to
+
+ export PATH="$PATH:$MAVEN_HOME/bin:$JAVA_HOME/bin"
+
+ On Linux make sure you path include MAVEN_HOME and JAVA_HOME.
+
+Software Dependencies
+---------------------
+
+ The Apache Flex SDK Converter uses third-party code that will be downloaded as
+ part of the build.
+
+ The Apache Version 2.0 license is in the LICENSE file.
+
+ The following dependencies have licenses which are, or are compatible with,
+ the Apache Version 2.0 license. You will not be prompted to acknowledge the
+ download. Most of the jars are installed in your maven local repository and
+ are included in the assembly jars.
+
+Building the Source in the Source Distribution
+----------------------------------------------
+
+ The project is built with Apache Maven so for a reference to Maven commands
+ please have a look at the Maven documentation.
+
+ When you have all the prerequisites in place and the environment variables
+ set (see Install Prerequisites above) use
+
+ cd <flax-sdk-converter.dir>
+ mvn install
+
+ to download the third-party dependencies and build the binary from the source.
+
+ To clean the build, of everything other than the downloaded third-party
+ dependencies use
+
+ mvn clean
+
+ The packages can be found in the "target" subdirectories.
+
+ The particularly interesting one is the Standalone Command Line Interface:
+ - cli/target/apache-flex-sdk-converter-1.0.0.jar
+
+
+
+Using the Apache Flex SDK Converter
+===================================
+
+ The CLI (Command Line Interface) allows the Apache Flex SDK Converter
+ to be executed from the command-line. Assuming the Java executable is
+ available on the current systems path, it can be called using:
+
+ cd <flex-sdk-converter.dir>/cli/target
+ java -jar apache-flex-sdk-converter-1.0.0.jar
+
+ If executed without any command, it will output a list of commands and
+ available properties.
+
+ In general it is able to perform 4 different commands:
+
+ - help Prints a list of all commands and options available.
+ - list Lists all versions and platforms available for download
+ - download Downloads selected versions and assembles an FDK
+ - convert Converts a previously installed (using the installer) or
+ assembled (using download command) FDK into a mavenized form.
+ - deploy Uploads previously created maven artifacts to a remote repository.
+
+Some typical usage scenarios
+----------------------------
+
+ - Create a mavenized version of a previously installed FDK (Using the installer):
+ "... -fdkDir <FDK install dir> -mavenDir <maven local repo> convert"
+
+ - Download and create an FDK (Flex 4.14.1 with playerglobal 17.0 and 16.0
+ AIR SDK 17.0 for Windows and Mac and the fontkit libs):
+ "... -fdkDir <FDK target dir> -flexVersion 4.14.1 -flashVersions 17.0,16.0 \
+ -airVersion 17.0 -platform WINDOWS,MAC -fontkit download"
+
+ - Download and convert an FDK (FDK assembled in temp directory using Air for
+ current systems platform only):
+ "... -flexVersion 4.14.1 -flashVersions 17.0 -airVersion 17.0 -fontkit \
+ -mavenDir <maven local repo> download convert"
+
+ - Deploy a bunch of maven artifacts to a remote maven repository:
+ "... -mavenDir <dir with maven artifacts> -repoUrl <url> \
+ -repoUsername <username> -repoPassword <pasword> deploy"
+
+ - "The works": Download, Convert and Deploy using only temp directories:
+ "... -flexVersion 4.14.1 -flashVersions 17.0 -airVersion 17.0 -fontkit \
+ -repoUrl <url> -repoUsername <username> -repoPassword <pasword> \
+ download convert deploy"
+
+
+Thanks for using Apache Flex. Enjoy!
+
+ The Apache Flex Project
+ <http://flex.apache.org>
+
+
+
+
+
+/////////////////////////////////////////////////////////////////////////////////////////
+Some information (HOWTO) to go with the deployer artifacts
+/////////////////////////////////////////////////////////////////////////////////////////
+
+The deployers are separate modules. Currently two implementations exist.
+1. The Maven deployer (located in deployers/maven/target/maven-deployer-1.0.0-full.jar)
+2. The Aether deployer (located in deployers/aether/target/aether-deployer-1.0.0-full.jar)
+
+The Maven-Deployer expects Maven to be installed on your system and issues a set of
+commandline commands in order to deploy the artifacts. This is the safest approach if you
+haven any special settings that need to be handled in order to deploy the artifacts.
+
+The Aether-Deplyoer uses the Maven-Internal aether libraries to deploy the artifacts from
+within the running JVM. This makes this approach a lot faster than the Maven-Deployer.
+
+/////////////////////////////////////////
+Usage for the Maven Deployer:
+/////////////////////////////////////////
+
+java -cp {home}/deployers/maven/target/maven-deployer-1.0.0-full.jar "directory" "repositoryId" "url" "mvn"
+
+The Maven-Deployer needs 4 ordered parameters separated by spaces:
+ 1- directory: The path to the directory to deploy.
+ 2- repositoryId: Server Id to map on the <id> under <server> section of settings.xml.
+ 3- url: URL where the artifacts will be deployed.
+ 4- mvn: The path to the mvn.bat / mvn.sh.
+
+/////////////////////////////////////////
+Usage for the Maven Deployer:
+/////////////////////////////////////////
+
+java -cp {home}/deployers/aether/target/maven-aether-1.0.0-full.jar "directory" "url" ["username" "password]
+
+The Aether-Deployer needs 2 ordered parameters separated by spaces:
+ 1- directory: The path to the directory to deploy.
+ 2- url: URL where the artifacts will be deployed.
+Optionally you can provide the username and password that is used for deploying artifacts.
+ 3- username: The username needed to log-in to the remote repository.
+ 4- password: The password needed to log-in to the remote repository.
+
+
Added: release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/RELEASE_NOTES
==============================================================================
--- release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/RELEASE_NOTES (added)
+++ release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/RELEASE_NOTES Mon Feb 20 22:20:28 2023
@@ -0,0 +1,31 @@
+Apache Flex Mavenizer 1.1.0
+===========================
+
+Apache Flex Mavenizer 1.1.0 fixes an HTTP to HTTPS redirect issue that causes
+Mavenized downloads to fail.
+
+Known Issues
+_____________
+
+Currently None.
+
+
+Apache Flex SDK Converter 1.0.0
+===========================
+
+Apache Flex SDK Converter 1.0.0 is the first release of a tool allowing, automating
+the conversion of Apache Flex FDKs into Maven artifacts that can be used by tools
+like FlexMojos to build Apache Flex application using Maven.
+
+Known Issues
+_____________
+
+Currently None.
+
+
+Please report new issues to our bug tracker at:
+
+ https://issues.apache.org/jira/browse/FLEX
+
+ The Apache Flex Project
+ <http://flex.apache.org/>
Added: release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/apache-flex-sdk-converter-1.1.0-source-release.zip
==============================================================================
Binary file - no diff available.
Propchange: release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/apache-flex-sdk-converter-1.1.0-source-release.zip
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/apache-flex-sdk-converter-1.1.0-source-release.zip.asc
==============================================================================
--- release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/apache-flex-sdk-converter-1.1.0-source-release.zip.asc (added)
+++ release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/apache-flex-sdk-converter-1.1.0-source-release.zip.asc Mon Feb 20 22:20:28 2023
@@ -0,0 +1,17 @@
+-----BEGIN PGP SIGNATURE-----
+
+iQJLBAABCgA1FiEEUIiMVgu2hVY9sz5N63ovhoDfT0gFAmPcPOwXHGpvc2h0eW5q
+YWxhQGFwYWNoZS5vcmcACgkQ63ovhoDfT0gVkQ//UQegFHKp3/Y84nGVv/fz1sOv
+dOgBwJAC9ZISor8vlQ93sgFz0nMIfrJ6ICDuhVqm1FsFlkzOuX7AeVodtlkzBcN7
+E6Rcee4r2LLxd0FwtwkIfEwO1DiM4bGVv/q7XFSbWCMDoEJhOzBHkORZztsyWjDj
+SvA9R8+/t/lGlnQOcYgI05t1MQCMGvMZOL+pWLOLYMNdq/OqgUZQSo8bQlWBL4z2
+TjdQsmhfxxJjUWsnB1Es/q/d/fkvwgwW670kxb1ntna47dpQp8PZ/m0Obwol3ueD
+Dpue/S+gFr2wzXRSLPKSCPqo3fWDzl5sYEU8S+e3PzLN8d95dHEcZVB6NXEP+J9D
+UZtIuHm7oH4eGeUqbM7r0SdXCFZInGFjHWp2BXDclste9//vLQv4qIviV0c/SR3f
+DtauF5n1QRXZjT7dsZiVrjF8EI4SDVcE73edwEv37bAdV3n+6HRaNXV3MRCKxFjU
+csxQ5B18y1JPyTUDlHXc3AJp7MhgAR4/88V0L/VjIRkyZpXnHmFoxHYXV2FePmPp
+9lyDeOcJ02/ZYuFP+vagrY0u6sJfjBXABsaizC+uvnX7n6p2I/cLZOndD3wSJEUQ
+MFdBwANeSEg1sRIbAiPkfQjDkuVHpNYl/cW8fsXVLy+6TdqE5GenCq986/VGpBr6
+DgJk8Jii3Y4q7ObVDdU=
+=5Ae6
+-----END PGP SIGNATURE-----
Added: release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/apache-flex-sdk-converter-1.1.0-source-release.zip.sha512
==============================================================================
--- release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/apache-flex-sdk-converter-1.1.0-source-release.zip.sha512 (added)
+++ release/flex/flex-maven-tools/flex-sdk-converter/1.1.0/apache-flex-sdk-converter-1.1.0-source-release.zip.sha512 Mon Feb 20 22:20:28 2023
@@ -0,0 +1 @@
+8a7e00197dd67dbdf2bfe957423b1003d878fa73a0769a0e802f9be3bcb937ffa6fc5708d57c22cf6642cfecef1b485f6c3e4bf4e5e77d688ddb0c87821c0426
\ No newline at end of file