First commit

This commit is contained in:
MassiveBox 2022-08-20 19:41:38 +02:00
commit ae520ca016
3 changed files with 39 additions and 0 deletions

2
.gitignore vendored Normal file
View file

@ -0,0 +1,2 @@
mount
project.geany

20
Dockerfile Normal file
View file

@ -0,0 +1,20 @@
FROM debian:bullseye
RUN apt-get update; \
apt-get upgrade -y; \
apt-get install git make gcc file g++ wget cpio python unzip rsync bc bzip2 mercurial squashfs-tools -y; \
git clone https://github.com/retrofw/buildroot-retrofw-2.3.git buildroot; \
mkdir mount
WORKDIR buildroot
RUN git checkout remotes/origin/2021.11.x; \
make RetroFW_defconfig BR2_EXTERNAL=board/retrofw; \
env FORCE_UNSAFE_CONFIGURE=1 make toolchain sdl sdl_image sdl_mixer sdl_sound; \
echo 'export PATH=/buildroot/output/host/bin:/buildroot/output/host/mipsel-RetroFW-linux-uclibc/sysroot/usr/bin:$PATH' >> ~/.bashrc
RUN make sdl_ttf
WORKDIR /mount
ENTRYPOINT echo "Container started, now execute bash shell to continue."; sleep infinity

17
README.md Normal file
View file

@ -0,0 +1,17 @@
# 🐳🎮 RetroFW Docker Buildroot
The RetroFW Docker Buildroot is a Docker image designed to install the [RetroFW Buildroot](https://github.com/retrofw/buildroot-retrofw-2.3) in an elegant, platform-independent and containerized way.
The ultimate goal is to simplify the software development process for RetroFW users, by automating the installation of dependencies and common libraries, and avoiding all the conflicts that the Buildroot can cause while compiling other software.
⚠️ **Check out the [Wiki](/massivebox/retrofw-docker-buildroot/wiki) for more information, detailed installation instructions, troubleshooting tips, examples, support and more.**
### Quick get-started guide
1. Get the image using `docker pull gitea.massivebox.net/massivebox/retrofw-docker-buildroot:latest`
2. Create a container that uses the provided image using `docker create -v CHANGEME:/mount --name buildroot gitea.massivebox.net/massivebox/retrofw-docker-buildroot`. Replace `CHANGEME` with the absolute path of a folder in your computer where you will be able to edit files from inside the container.
3. Start the container using `docker start buildroot` and connect to its Bash shell using `docker exec -it buildroot /bin/bash`.
4. Compile your project as usual. If you're having issues, check out the [Troubleshooting wiki page](/massivebox/retrofw-docker-buildroot/wiki/Troubleshooting).
5. When you're done, stop the container with `docker stop buildroot`. Next time you want to compile using the Buildroot, repeat from step 3.
### Licensing
The code in this repository is licensed under [GPLv3](https://www.gnu.org/licenses/gpl-3.0.html). The software that is required to run it and the software that it compiles might use a different license. Make sure to comply with all of them.
The Wiki and the README.md file are licensed under [GFDL](https://www.gnu.org/licenses/licenses.html#FDL).