This is docker images that can be used to build adtools for AmigaOS 4
Go to file
George Sokianos 7b0469fefc Cleanup and documentation 2022-02-01 19:33:48 +00:00
files Initial commit 2022-02-01 18:47:39 +00:00
.dockerignore Initial commit 2022-02-01 18:47:39 +00:00
.env6 Initial commit 2022-02-01 18:47:39 +00:00
.env8 Initial commit 2022-02-01 18:47:39 +00:00
.env9 Initial commit 2022-02-01 18:47:39 +00:00
.env10 Initial commit 2022-02-01 18:47:39 +00:00
.env11 Initial commit 2022-02-01 18:47:39 +00:00
.gitignore Cleanup and documentation 2022-02-01 19:33:48 +00:00
Dockerfile Cleanup and documentation 2022-02-01 19:33:48 +00:00
Makefile Cleanup and documentation 2022-02-01 19:33:48 +00:00
README.md Cleanup and documentation 2022-02-01 19:33:48 +00:00
build-gcc.sh Initial commit 2022-02-01 18:47:39 +00:00

README.md

adtoolsBuilder

This is docker images that can be used to build native adtools for AmigaOS 4 on every operating system that supports Docker.

Setup

To prepare the environment you need to do the following:

  1. Clone the necessary repos under the repos folder

    make clonerepos
    
  2. Copy the latest ExecSG private SDK under repos folder. So the path should be repos/execsg_private_sdk/SDK/...

    If this folder does not exist the following step will fail with an error like below.

    Step 15/17 : ADD ${REPOS_PATH}/execsg_private_sdk /tmp/execsg_private_sdk
    ADD failed: file not found in build context or excluded by .dockerignore: stat repos/execsg_private_sdk: file does not exist
    make: *** [Makefile:41: build] Error 1
    
  3. Build the docker image

    make build
    

    This will create the walkero/adtoolsbuilder:adtools-build Docker image, with size around 1.88GB. So make sure you have this available space at your hard disk.

After this steps you are ready to compile the adtools on your machine.

Compile adtools

To compile adtools you first need to create a Docker container based on which GCC version you want to build. Available versions are 6, 8, 10, 11. To do that you just need to run the following:

make gcc8

Change the number based on which version you would like to compile.

Then you can execute the build-gcc.sh script to run all the steps, or do them by hand.

CAUTION: Because of a bug, the make native-install command might fail the first time you run it, but it will succeed if you run it a second time. That's why it is recommended to execute the commands by hand, until this bug is fixed.

Useful information

  1. When you start a container to compile adtools in there, a new folder will be created named native-gcc. In there new folders will be created with the gcc files and the distribution lha packages for adtools and clib. This way you can get those files from the host machine.
  2. By default, the adtools is compiled using the latest AmigaOS 4 SDK v53.34. If you would like to compile them using the previous v53.30, then open the Makefile and change the makefile-SDK53.34 to makefile-SDK53.30. By doing that the latest ExecSG private SDK is not used, and you can have an empty folder under repos directory.
  3. If you don't have the latest ExecSG private SDK, then check the above line on what to do.
  4. If you want to update the cloned repos and rebuild the Docker image, just run make buildnc. This will pull the latest code for the necessary repos and will re-create the Docker image. The files native-build/Makefile, gcc-build/features.mk and gcc-build/Makefile are not updated though, because custom ones are used. If there are updates at the adtools repo, these need to be applied manually, with caution. The custom files can be found under files/ folder.