Author: cdutz Date: Sat Nov 16 13:42:25 2019 New Revision: 36769 Log: Add direcory for rc2
Added: dev/flex/flex-maven-tools/flex-sdk-converter/rc2/README.txt dev/flex/flex-maven-tools/flex-sdk-converter/rc2/RELEASE_NOTES dev/flex/flex-maven-tools/flex-sdk-converter/rc2/apache-flex-sdk-converter-1.0.0-source-release.zip (with props) dev/flex/flex-maven-tools/flex-sdk-converter/rc2/apache-flex-sdk-converter-1.0.0-source-release.zip.asc dev/flex/flex-maven-tools/flex-sdk-converter/rc2/apache-flex-sdk-converter-1.0.0-source-release.zip.sha512 Added: dev/flex/flex-maven-tools/flex-sdk-converter/rc2/README.txt ============================================================================== --- dev/flex/flex-maven-tools/flex-sdk-converter/rc2/README.txt (added) +++ dev/flex/flex-maven-tools/flex-sdk-converter/rc2/README.txt Sat Nov 16 13:42:25 2019 @@ -0,0 +1,223 @@ +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. + +TODO: Add them all here ... + +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: dev/flex/flex-maven-tools/flex-sdk-converter/rc2/RELEASE_NOTES ============================================================================== --- dev/flex/flex-maven-tools/flex-sdk-converter/rc2/RELEASE_NOTES (added) +++ dev/flex/flex-maven-tools/flex-sdk-converter/rc2/RELEASE_NOTES Sat Nov 16 13:42:25 2019 @@ -0,0 +1,19 @@ +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: dev/flex/flex-maven-tools/flex-sdk-converter/rc2/apache-flex-sdk-converter-1.0.0-source-release.zip ============================================================================== Binary file - no diff available. Propchange: dev/flex/flex-maven-tools/flex-sdk-converter/rc2/apache-flex-sdk-converter-1.0.0-source-release.zip ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/flex/flex-maven-tools/flex-sdk-converter/rc2/apache-flex-sdk-converter-1.0.0-source-release.zip.asc ============================================================================== --- dev/flex/flex-maven-tools/flex-sdk-converter/rc2/apache-flex-sdk-converter-1.0.0-source-release.zip.asc (added) +++ dev/flex/flex-maven-tools/flex-sdk-converter/rc2/apache-flex-sdk-converter-1.0.0-source-release.zip.asc Sat Nov 16 13:42:25 2019 @@ -0,0 +1,16 @@ +-----BEGIN PGP SIGNATURE----- + +iQIzBAABCgAdFiEE8VaBP/MVAH42umwTCJEnwVxg1rkFAl3P+oUACgkQCJEnwVxg +1rlf4BAAnOiZGFyqgKNBq7Rm603cXTWDO0haZuDsM5Ov7LbF2KQCFQId+EFwRTJl +HE/1tiSrYsNfp5TPC2Tcyuyl/3GL1m1nxRfiPxUZWA34WuB+xeVeZtP6DpBQvOee +Z3S0GRLtX/pNpIQ1OvEO5iEK9KsZTrQCQVeZ/k49/v66rTjAl95SrO9JiiBjsiRy +aQp/bPsgKEonWgK3bxoQVYegcDwUbki2jlJe50aW+a7U3/IEyCY8z4tqhnBXngqo +XPaB8NEg7WQdvEWXrlIhNFCxZJm7IifhyR+aMz0V4Vuuz5CeH7fHTy/WPaF7MdyP +Gs0k12KLHLW+dneJpFiw+1Nkmw45KzN4wyizJ3oCk+DYm6G9Iv5RVxuI099alV4M +fb+szkIs9d3kwx1DJGB6eHAPtrOCTB96EL7e2vZcloVuR0yO5iJSpsxzH75yd6HD +hef1OWuAUvCVIYOKNUan/ha5He+Wh5ZzS9p0Zd+zIJH+vnd1Hnh/84Wdr4fqYSeK +N27LckihHwjq74N+oiy5qz1SUhM049uFgOem0YnFHuyrYwK6zxX4RNlCbN6w/LTP +k0GN5MPHnvVBZNZkoMWPDYp3dumLIDfna49wKGrwkR1SS/cNcICEb3FY5DXmOccg +/gaTkCiXCKqh/rQ4ijo8jEv5ev/4pE0Nn9AkZV2lkAqCgJXEJ9M= +=r0GH +-----END PGP SIGNATURE----- Added: dev/flex/flex-maven-tools/flex-sdk-converter/rc2/apache-flex-sdk-converter-1.0.0-source-release.zip.sha512 ============================================================================== --- dev/flex/flex-maven-tools/flex-sdk-converter/rc2/apache-flex-sdk-converter-1.0.0-source-release.zip.sha512 (added) +++ dev/flex/flex-maven-tools/flex-sdk-converter/rc2/apache-flex-sdk-converter-1.0.0-source-release.zip.sha512 Sat Nov 16 13:42:25 2019 @@ -0,0 +1 @@ +9a1b599dac0ca9a09d6ec54c36f34ba85df77714d78c4df8f1f417418578e208b8353fad2ac45be50b3a11bdaeaec7273f99fd7a30c7d9105b36516185677c9d \ No newline at end of file