XM8 for macOS

---

XM8 for macOSとは

---

XM8は、ＰＩ．さんが開発したマルチプラットフォーム（Windows/Linux/Android）に対応したPC-8801MA(PC-8801mkIISR上位互換)のエミュレータをmacOS用に改変したものです。

このリポジトリは ＰＩ．さんから許可をいただき作成しています。

公式では配布されていないmacOS版の開発を主に行なっていきますが、Windows/Linux/Android版もできる限り配布します。

公式はこちらです。

http://retropc.net/pi/xm8/index.html

インストール方法

---

リリースからお手持ちの環境にあった実行ファイルをダウンロードしてください。

XM8.appをアプリケーションフォルダに移動するなどして実行してください。

動作環境

CPU	最小OSバージョン	実行ファイル
x86_64	macOS 10.13 High Sierra	x86_64版
Apple Silicon	macOS 11 Big Sur	Apple Silicon版

その他のOSはリリースを見てください。

ROMファイル

---

使用できるROMファイルについては、README-XM8.txtの[ROMファイル]を参照してください。

配置場所

ROMファイルの配置場所は、設定ファイルと同じ以下になります（一度、アプリケーションを起動するとフォルダが作成されます）。

"~/Library/Application Support/retro_pc_pi/xm8"

使用方法

---

README-XM8.txtの[使い方]を参照してください。

ビルド方法

---

ビルド環境

ビルドするには以下のインストールが必要です。

• Xcode

  使うのはコマンドラインツールだけですが、Xcodeをインストールしてしまうのが手っ取り早いと思います。

• Homebrew

  Homebrewのインストールが必要です。 cmakeなどビルドに必要なツールの取得に使用します。

ビルド手順

プロジェクトのルートをターミナルで開き、以下のコマンドを実行します。

cd Builder/macOS
./dist_app.sh

これでbuildフォルダに実行ファイル(.app)が作成されているはずです。

謝辞

---

ソースコードの改変を快諾してくださったＰＩ．氏にお礼申し上げます。

その他のOS

---

Windows版

---

Builder/WindowsフォルダにVisual Studio 2022用のソリューションが入っています。

Builder/Windowsフォルダにあるsetup_sdl2.ps1を実行すると、ビルドに必要なSDL2をダウンロードして適切な場所に配置します。

以下のようになります。

• Builder\Windows\SDL\include（インクルードファイル）
• Builder\Windows\SDL\lib\x86（x86向けライブラリ）
• Builder\Windows\SDL\lib\x64（x64向けライブラリ）
• Builder\Windows\SDL\lib\arm64（arm64向けライブラリ）

Builder/Windows/XM8.sln をVisual Studioでビルドします。 Builder/Windows/x64、Builder/Windows/Win32、Builder/Windows/ARM64に出力されます。実行に必要なのは、XM8.exeとSDL2.dllです。

BIOS ROMファイルの置き場所は以下になります。

%appdata%\retro_pc_pi\xm8

Linux版

---

Builder/Linuxフォルダにdeb, rpm, appimageパッケージを作成するスクリプトが入っています。

ビルドに必要なライブラリは、dist_app.shを参照してください。

deb or rpm

cd Builder/Linux
./dist_app.sh

これでbuildフォルダにdebファイル、またはrpmファイルが作成されます。

appimage

cd Builder/Linux
./appimage.sh

これでBuilder/Linuxフォルダに、appimageファイルが作成されます。

BIOS ROMファイルの置き場所は以下になります。

~/.local/share/retro_pc_pi/xm8/

Android版

---

Builder/AndroidフォルダにAndroid Studio用のプロジェクトが入っています。

Builder/Androioフォルダにあるsetup_sdl2.shを実行すると、ビルドに必要なSDL2をダウンロードして適切な場所に配置します。

以下のようになります。

• Builder/Android/app/jni/SDL\include（インクルードファイル）
• Builder/Android/app/jni/SDL\src（ソースファイル）
• Builder/Android/app/src/java/org/libsdl/app（Javaソースファイル）

Builder/AndroidをAndroid Studioで開いてビルドします。

BIOS ROMファイルの置き場所は以下になります。

Android/data/retro_pc_pi/files/

Android 11以上の場合、端末内のファイルに自由にアクセスすることができません。

ゲームのディスクイメージも同じ場所に入れることを推奨します。

使用しているOSSのライセンス

• xBRZ

  https://sourceforge.net/projects/xbrz/

  GNU General Public License version 3.0 (GPLv3)