2016-05-31 14:45:49 +00:00
|
|
|
Building a game disk image for the Apple II Platform
|
|
|
|
|
====================================================
|
2013-08-12 14:14:08 +00:00
|
|
|
|
2016-05-31 14:45:49 +00:00
|
|
|
1. Install dependencies
|
2013-08-12 14:14:08 +00:00
|
|
|
|
2016-05-31 14:45:49 +00:00
|
|
|
The platform build for the Apple II requires only two dependencies. You will need to install these and have them in your path before you try to build.
|
2013-09-13 15:46:47 +00:00
|
|
|
|
2016-05-31 14:45:49 +00:00
|
|
|
- Java 8 (or higher). You can use either OpenJDK 1.8+ or Sun JDK 1.8+
|
|
|
|
|
- Apache ant 1.9 (or higher)
|
2013-09-13 15:46:47 +00:00
|
|
|
|
2016-05-31 14:45:49 +00:00
|
|
|
You can check if you already have them this way:
|
|
|
|
|
- `java -version` # should show "1.8.xxx"
|
|
|
|
|
- `ant -version` # should show "1.9.x"
|
2013-09-13 15:46:47 +00:00
|
|
|
|
2016-05-31 14:45:49 +00:00
|
|
|
2. Build the tools
|
2013-08-12 14:14:08 +00:00
|
|
|
|
2016-05-31 14:45:49 +00:00
|
|
|
- `cd Platform/Apple`
|
|
|
|
|
- `ant`
|
2013-08-12 14:14:08 +00:00
|
|
|
|
2016-05-31 14:45:49 +00:00
|
|
|
3. Put scenario files in place
|
2013-08-12 14:14:08 +00:00
|
|
|
|
2016-05-31 15:32:41 +00:00
|
|
|
You will need acquire and place three scenario files into the appropriate subdirectories of `Platform/Apple/virtual/` as follows:
|
|
|
|
|
- `Platform/Apple/virtual/data/world/world.xml`
|
|
|
|
|
- `Platform/Apple/virtual/data/world/enemies.tsv`
|
|
|
|
|
- `Platform/Apple/virtual/data/fonts/font.bin`
|
2016-05-31 14:45:49 +00:00
|
|
|
|
|
|
|
|
4. Build a game disk
|
|
|
|
|
|
|
|
|
|
- `cd Platform/Apple/virtual`
|
|
|
|
|
- `ant`
|
|
|
|
|
- The resulting disk image will be `Platform/Apple/Virtual/game.2mg`. Just boot it in an emulator or copy to a real Apple II, and have fun.
|
|
|
|
|
|
|
|
|
|
5. Rinse and repeat
|
|
|
|
|
|
|
|
|
|
- Change any of the code files in virtual/src, or update the world.xml file using Outlaw
|
|
|
|
|
- Go to step 4. The system uses incremental building for speedy turnaround.
|
