Codespaces - Revision history

Tchan: replace last ref to one of Colton's old containers, with latest-stable

2025-02-04T19:12:34Z

replace last ref to one of Colton's old containers, with latest-stable

← Older revision		Revision as of 19:12, 4 February 2025
Line 139:		Line 139:
	<syntaxhighlight lang="bash">		<syntaxhighlight lang="bash">
	# Stage 1		# Stage 1
	FROM "ghcr.io/kos-builds/kos-ports-dc:~~sha~~-~~656a397-14.1.0~~" as build		FROM "ghcr.io/kos-builds/kos-ports-dc:latest-stable" as build

	# Add mkdcdisc		# Add mkdcdisc

Tchan: point to Colton's latest-stable container, instead of an old specific version

2025-02-04T19:11:13Z

point to Colton's latest-stable container, instead of an old specific version

← Older revision		Revision as of 19:11, 4 February 2025
Line 33:		Line 33:

	// Either use a pre-built image (= a Docker container)...		// Either use a pre-built image (= a Docker container)...
	"image": "ghcr.io/kos-builds/kos-ports-dc:~~sha~~-~~656a397-14.1.0~~",		"image": "ghcr.io/kos-builds/kos-ports-dc:latest-stable",
	// ... or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile		// ... or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
	//"build": { // Path is relative to the devcontainer.json file.		//"build": { // Path is relative to the devcontainer.json file.
Line 107:		Line 107:

	// Either use a pre-built image (= a Docker container)...		// Either use a pre-built image (= a Docker container)...
	//"image": "ghcr.io/kos-builds/kos-ports-dc:~~sha~~-~~656a397-14.1.0~~",		//"image": "ghcr.io/kos-builds/kos-ports-dc:latest-stable",
	// ... or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile		// ... or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
	"build": { // Path is relative to the devcontainer.json file.		"build": { // Path is relative to the devcontainer.json file.

Tchan: /* Example 1: Build an .elf from a KallistiOS example */ forcing the image to display at the right place

2024-07-15T18:19:24Z

Example 1: Build an .elf from a KallistiOS example: forcing the image to display at the right place

← Older revision		Revision as of 18:19, 15 July 2024
Line 64:		Line 64:
	* Go back to the root directory of your repository		* Go back to the root directory of your repository
	* Launch your Codespace by clicking on the "<> Code" button, then "Codespaces" - "Create codespace on master".		* Launch your Codespace by clicking on the "<> Code" button, then "Codespaces" - "Create codespace on master".
	[[File:Screen Shot 2024-07-14 at 8.28.13 AM.png\|thumb]]		{\|
			\|[[File:Screen Shot 2024-07-14 at 8.28.13 AM.png\|thumb]]
			\|}
	* This will launch Visual Studio Code in your browser. The first time it will take a couple of minutes to launch, after that it will be faster.		* This will launch Visual Studio Code in your browser. The first time it will take a couple of minutes to launch, after that it will be faster.
	* 3-bars-Menu at the top left - Terminal - New Terminal		* 3-bars-Menu at the top left - Terminal - New Terminal

BBHoodsta: /* Example 1: Build an .elf from a KallistiOS example */

2024-07-14T15:30:10Z

Example 1: Build an .elf from a KallistiOS example

← Older revision		Revision as of 15:30, 14 July 2024
Line 64:		Line 64:
	* Go back to the root directory of your repository		* Go back to the root directory of your repository
	* Launch your Codespace by clicking on the "<> Code" button, then "Codespaces" - "Create codespace on master".		* Launch your Codespace by clicking on the "<> Code" button, then "Codespaces" - "Create codespace on master".
			[[File:Screen Shot 2024-07-14 at 8.28.13 AM.png\|thumb]]
	* This will launch Visual Studio Code in your browser. The first time it will take a couple of minutes to launch, after that it will be faster.		* This will launch Visual Studio Code in your browser. The first time it will take a couple of minutes to launch, after that it will be faster.
	* 3-bars-Menu at the top left - Terminal - New Terminal		* 3-bars-Menu at the top left - Terminal - New Terminal

Tchan: writing Example 4

2024-07-14T07:58:37Z

writing Example 4

← Older revision		Revision as of 07:58, 14 July 2024
Line 148:		Line 148:

	== Example 4: Build something not from KallistiOS ==		== Example 4: Build something not from KallistiOS ==
	* ~~TODO~~		All the previous examples started by forking the KallistiOS repository, but most often you'll just want to work on your own code / another Dreamcast project, so you'll work from a repository other than KallistiOS:
			* login into [https://www.github.com github]
			* create/go to your own repository, or fork an existing project (eg doom64-dc, ...)
			* add at least ./devcontainer/devcontainer.json, and ./devcontainer/Dockerfile if needed
			* create/launch your codespace
			* follow the build instructions of that project
			* Notes:
			** Everything for KallistiOS should be available in the terminal, you'll find KallistiOS stuff in the folder /opt/toolchains/dc
			** In the file-tree on the left side, you'll see the files of your repository (folder: /workspaces). If you also want to add other folders there, eg /opt/toolchains/dc, execute something like this in the terminal: code -a /opt/toolchains/dc

	== Tips ==		== Tips ==

Tchan: Example 3: fix cd /opt/toolchains/dc/mkdcdisc

2024-07-14T07:18:09Z

Example 3: fix cd /opt/toolchains/dc/mkdcdisc

← Older revision		Revision as of 07:18, 14 July 2024
Line 140:		Line 140:
	# Add mkdcdisc		# Add mkdcdisc
	RUN git clone https://gitlab.com/simulant/mkdcdisc /opt/toolchains/dc/mkdcdisc \		RUN git clone https://gitlab.com/simulant/mkdcdisc /opt/toolchains/dc/mkdcdisc \
	&& cd mkdcdisc \		&& cd /opt/toolchains/dc/mkdcdisc \
	&& meson setup builddir \		&& meson setup builddir \
	&& meson compile -C builddir \		&& meson compile -C builddir \

Tchan: Example 3: fixing Dockerfile errors

2024-07-14T07:07:40Z

Example 3: fixing Dockerfile errors

← Older revision		Revision as of 07:07, 14 July 2024
Line 136:		Line 136:
	<syntaxhighlight lang="bash">		<syntaxhighlight lang="bash">
	# Stage 1		# Stage 1
	FROM ghcr.io/kos-builds/kos-ports-dc:sha-656a397-14.1.0 as build		FROM "ghcr.io/kos-builds/kos-ports-dc:sha-656a397-14.1.0" as build

	# Add mkdcdisc		# Add mkdcdisc
	RUN git clone https://gitlab.com/simulant/mkdcdisc /opt/toolchains/dc/mkdcdisc \		RUN git clone https://gitlab.com/simulant/mkdcdisc /opt/toolchains/dc/mkdcdisc \
	&& cd mkdcdisc		&& cd mkdcdisc \
	&& meson setup builddir		&& meson setup builddir \
	&& meson compile -C builddir		&& meson compile -C builddir \
	&& cp ./builddir/mkdcdisc /opt/toolchains/dc/bin		&& cp ./builddir/mkdcdisc /opt/toolchains/dc/bin
	</syntaxhighlight>		</syntaxhighlight>

Tchan: finishing example 3

2024-07-14T06:54:12Z

finishing example 3

← Older revision		Revision as of 06:54, 14 July 2024
Line 145:		Line 145:
	&& cp ./builddir/mkdcdisc /opt/toolchains/dc/bin		&& cp ./builddir/mkdcdisc /opt/toolchains/dc/bin
	</syntaxhighlight>		</syntaxhighlight>
			* The next time you create a repository & copy the above 2 files in it, you will get a codespace with mkdcdisc already correctly installed !

	== Example 4: Build something not from KallistiOS ==		== Example 4: Build something not from KallistiOS ==

Tchan: example 3 dockerfile: remove kos download

2024-07-14T06:51:48Z

example 3 dockerfile: remove kos download

← Older revision		Revision as of 06:51, 14 July 2024
Line 139:		Line 139:

	# Add mkdcdisc		# Add mkdcdisc
	~~RUN git clone https://github.com/KallistiOS/KallistiOS.git /opt/toolchains/dc/kos \~~
	~~&& cd /opt/toolchains/dc/kos \~~
	~~&& cp ./doc/environ.sh.sample ./environ.sh \~~
	~~&& source environ.sh \~~
	~~&& make~~
	RUN git clone https://gitlab.com/simulant/mkdcdisc /opt/toolchains/dc/mkdcdisc \		RUN git clone https://gitlab.com/simulant/mkdcdisc /opt/toolchains/dc/mkdcdisc \
	&& cd mkdcdisc		&& cd mkdcdisc

Tchan: fixing syntaxhighlight closures

2024-07-14T06:50:53Z

fixing syntaxhighlight closures

← Older revision		Revision as of 06:50, 14 July 2024
Line 131:		Line 131:
	// "remoteUser": "root"		// "remoteUser": "root"
	}		}
	<syntaxhighlight>		</syntaxhighlight>

	* ... and add a new file: ./devcontainer/Dockerfile		* ... and add a new file: ./devcontainer/Dockerfile
Line 149:		Line 149:
	&& meson compile -C builddir		&& meson compile -C builddir
	&& cp ./builddir/mkdcdisc /opt/toolchains/dc/bin		&& cp ./builddir/mkdcdisc /opt/toolchains/dc/bin
	<syntaxhighlight>		</syntaxhighlight>

	== Example 4: Build something not from KallistiOS ==		== Example 4: Build something not from KallistiOS ==