Skip to content

Latest commit

 

History

History
104 lines (66 loc) · 3.3 KB

README.md

File metadata and controls

104 lines (66 loc) · 3.3 KB
Raw

vscode-remote-gb-dev

Preparing for the OJYUKEN = VSCode + Docker + GBDK-2020

Get Started

This template is the development environment template for GB.

With the combination of VSCode and Docker, GBDK-2020, you can easily start developing right away. Of course, you can also emulate your compiled GB application.

Requirements

Install the following tools.

  1. git
  2. VSCode
  3. Docker

If you want to create your repository by use this template, sign up and sign in github.

How to use

Use this template

  1. Open the repository on github.
    https://github.com/ojyuken/vscode-remote-gb-dev

  2. Click Use this template.
    Here - https://github.com/ojyuken/vscode-remote-gb-dev/generate

git clone

  1. Open the command prompt and run below commands.
mkdir c:\workgit
cd c:\workgit
git clone <your GitHub Code URL>

VSCode, Reopen in Container

  1. Open the git cloned folder in VSCode.
  2. Install the "Remote - Containers" extension to VSCode.
  3. An icon for the extension "Remote - Containers" will be added to the bottom left corner of VSCode, click on that icon.
  4. Select "Remote-Containers: Reopen in Container" from the list.
  5. The Docker container will start and you will be able to develop remotely from VSCode.

GB development tools

GB development tools installed, /opt.

  1. gbdk-2020 - /opt/gbdk
  2. rgbds - /opt/rgbds

Open http://localhost:8080, then select the fluxbox menu (right-click on desktop.)
You can use the following tools via noVNC:

  1. gameboy tile designer (gbtd)
  2. gameboy map builder (gbmb)
  3. gameboy emulator (bgb)

Also, it included gbtdg which is great for making splash images.
http://localhost:8080/gbtdg/

Example

An example by konsumer is included, so you can build and run it.

Following commands, and then open http://localhost:8080.

cd /home/gbdev/workspace/.devcontainer/docker-gb-dev/example
make
wine /opt/bgb/bgb.exe demo.gb

You can also try the gbdk-2020 examples as well.

cd /opt/gbdk/examples/gb

More Info

Here are the tools installed in this environment:

The GB's homepage is here (Japanese).