walkero/dde4aros repository overview

⁠dde4aros

dde4aros stands for docker Development Environment for AROS. Using this docker image you are able to compile AROS from sources on any system where docker is installed.

⁠Usage

If you don't have docker installed on your system, you better install it, so to use this image.

• Windows⁠
• Mac⁠
• Linux⁠

⁠Run docker image

To create a container with the dde4aros docker image, so that you are able to compile your projects for AROS, execute the following command inside your terminal.

cd your-apps-folder

docker run -it --rm --name dde4aros -v "$PWD":/usr/src -w /usr/src walkero/dde4aros:latest /bin/bash

When you use the above command you will get into the docker Development Environment for AROS. So you will see in your terminal something like:

root@a1abef0bbe0a:/usr/src#

⁠Update docker image

To update your docker image to the latest version, execute the following inside your terminal.

docker pull walkero/dde4aros:latest

⁠Build AROS

Let's build AROS on this Development Environment. I assume that you have GIT and and IDE installed on your system.

1. Create a folder where you are going to keep all your sources.
2. Open a terminal and go into that directory
3. Now, clone from github AROS sources

   git clone https://github.com/aros-development-team/AROS.git
   

   Copy
4. Run the docker image, as it is shown above

   docker run -it --rm --name dde4aros -v "$PWD":/usr/src -w /usr/src walkero/dde4aros:latest /bin/bash
   

   Copy
5. Do the following to compile AROS

   cd AROS
   ./configure --target=pc-x86_64 --enable-ccache --with-gcc-version=9.1.0 --with-binutils-version=2.32 --with-portssources=/usr/src/AROS
   make -j 2 && make -j 2 distfiles
   

   Copy
   The above will compile AROS and create a distribution ISO. If you need to rebuild it after some changes, do:

   make -j 2 bootiso-quick
   

   Copy
6. To get out of the docker container just type exit and press enter.
7. When you exit the container is deleted, but NOT your code, as they remain in the host machine.
8. To get back in, just use the docker command from step 4

⁠Build ApolloOS for Vampire

Let's build ApolloOS for Vampire on this Development Environment. I assume that you have GIT and and IDE installed on your system.

1. Open a terminal and go into the directory where you want to pull the code for ApolloOS
2. Now, clone from github.com

   git clone --recursive https://github.com/ApolloTeam-dev/AROS.git -b master-new ApolloOS_Master
   

   Copy
3. Run the docker image, as it is shown above

   docker run -it --rm --name dde4aros -v "$PWD":/usr/src -w /usr/src walkero/dde4aros:latest /bin/bash
   

   Copy
4. Do the following to compile AROS

   cd ApolloOS_Master
   ./rebuild_rom.sh
   

   Copy
5. To get out of the docker container just type exit and press enter.
6. When you exit the container is deleted, but NOT your code, as they remain in the host machine.
7. To get back in, just use the docker command from step 4

More info about building ApolloOS can be found at https://github.com/ApolloTeam-dev/AROS/wiki/Building⁠

⁠Benefits of using docker images for development

There are a lot of benefits of using docker images for development, to work on AROS or your very own projects:

• Setup your development environment on any operating system that supports docker in minutes
• All the developers of the project have the same development environment
• Small footprint of the Development Environment
• docker images can be updated. The developers can use the latest TAG to get the latest version, or specific version TAG, to stick on a specific version
• The codes are shared between the host computer and the docker container
• Use any tools you like for development on the host computer (Version Control Systems, IDE etc.)
• Development Environment isolation
• Docker images can be used on CI/CD implementation to automate processes

⁠Credits

This docker image installation is based on http://vmwaros.blogspot.com/2019/09/setting-up-64bit-linux-development-env.html⁠ by Paolo Besser