... | ... | @@ -26,40 +26,30 @@ Local Build |
|
|
-----------
|
|
|
|
|
|
##### Install an AF3 developer installation for local building
|
|
|
The preferred platform for locally building AF3 is Linux. The build works on Windows, however
|
|
|
in the resulting Linux distribution the following changes have to applied:
|
|
|
|
|
|
The build works on Windows as well as on Linux. The preferred platform for locally building AF3 is Linux. However, in the resulting Linux distribution the following changes have to applied so that it works under Linux:
|
|
|
```dos2unix autofocus3-phoenix && chmod a+x autofocus3-phoenix autofocus3-phoenix-binary```
|
|
|
. So, if you have finished the following steps and have a locally built AF3, use this command in the resulting AF3 folder.
|
|
|
|
|
|
Use the oomph script at
|
|
|
https://git.fortiss.org/af3/fortiss-std-env/-/raw/master/oomph/af3-releng.setup
|
|
|
when following the instructions at [AF3 Developer Installation](AF3 Developer Installation).
|
|
|
This will install a developer installation ready to build the RCP with
|
|
|
maven.
|
|
|
For both build, it is needed to have an AF3 developer installation, but with a small change to the normal one. Follow the the instructions of the usual [AF3 Developer Installation](AF3 Developer Installation), but when you need to select a setup file (or the link to it), you use this one:
|
|
|
```https://git.fortiss.org/af3/fortiss-std-env/-/raw/master/oomph/af3-releng.setup```
|
|
|
. This will install a developer installation ready to build the RCP with maven (you will get the master of "maven-releng" ("org.fortiss.af3.root") as the only repository within this installation).
|
|
|
|
|
|
##### Update to the latest version of the af3 plugins
|
|
|
|
|
|
1. Open the view “Git Repositories” from the “Quick access” box in the
|
|
|
top-right corner of eclipse.
|
|
|
2. Navigate to “maven-releng > Submodules”.
|
|
|
3. Select all submodules, open the context menu, and select “Switch
|
|
|
to > master”
|
|
|
When you have your AF3 developer installation with the "maven-releng" repository:
|
|
|
1. Open the view “Git Repositories” from the “Quick access” box in the top-right corner of eclipse.
|
|
|
2. Navigate to “maven-releng > Submodules”.
|
|
|
3. Select all submodules, open the context menu, and select “Switch to > master”
|
|
|
|
|
|
##### Triggering a maven build
|
|
|
|
|
|
- In the menu, go to “Run > Run configurations” (while being in the "Java" view/perspective).
|
|
|
- Select under "Maven Build" the configuration “Build All” and click run. **NOTE:**
|
|
|
There are also preconfigured launches for cleaning and running the
|
|
|
tests.
|
|
|
- After 10-15 minutes the build should be done:
|
|
|
- The artifacts can be found in
|
|
|
`<root dir>\git\maven-releng\products\af3\org.fortiss.af3.phoenix.product\target\products`.
|
|
|
- To start the product, extract the ZIP file for your platform.
|
|
|
The extracted versions in the same directory currently do not
|
|
|
seem to work.
|
|
|
- You may have to add the following to `autofocus3-phoenix.ini` to
|
|
|
enable start the product in case JDK/JRE 11 is not in the system
|
|
|
path: `-vm <path to>/OpenJDK11/bin/javaw.exe`
|
|
|
When you have your AF3 developer installation with the "maven-releng" repository and the wanted versions of the submodules (e.g., all masters of the plugins, see previous step):
|
|
|
1. While being in the "Java" view/perspective, navigate in the menu bar to “Run > Run configurations”
|
|
|
2. Select under "Maven Build" the configuration “Build All” and click run. **NOTE:** There are also preconfigured launches for cleaning and running the tests.
|
|
|
3. After 10-15 minutes the build should be done:
|
|
|
- The artifacts can be found in `<root dir>\git\maven-releng\products\af3\org.fortiss.af3.phoenix.product\target\products`.
|
|
|
- To start the product, extract the ZIP file for your platform. The extracted versions in the same directory do not seem to work for the moment and can be ignored.
|
|
|
- If you are under Linux, remember the command given above / in the beginning (dos2unix and chmod).
|
|
|
- You may have to add the following to `autofocus3-phoenix.ini` to enable start the product in case JDK/JRE 11 is not in the system path: `-vm <path to>/OpenJDK11/bin/javaw.exe` .
|
|
|
- Start/Test the local build by executing the AF3 start file: "autofocus3-phoenix(.exe)"
|
|
|
|
|
|
Creating a derivate product
|
|
|
---------------------------
|
... | ... | |