163 lines
4.7 KiB
Markdown
163 lines
4.7 KiB
Markdown
reicast
|
|
===========
|
|
reicast is a multi-platform Sega Dreamcast emulator.
|
|
|
|
This is a developer-oriented resource, if you just want bins head over to http://reicast.com/
|
|
|
|
Caution
|
|
-------
|
|
The source is a mess, and I need sleep.
|
|
We had to discover some interesting arm bugs on the cleaned/refactored branch right after the release.
|
|
Expect a much improved changed folder/make structure soon.
|
|
|
|
Rebranding/forks
|
|
----------------
|
|
If you are interested into further porting/adapting/whatever, *please* don't fork off. I hate that. Really.
|
|
|
|
Let's try to keep everything under a single project :)
|
|
|
|
Building for Android
|
|
--------------------
|
|
Tools required:
|
|
* Latest Android SDK
|
|
- http://developer.android.com/sdk/index.html
|
|
* NDK r8b or newer
|
|
- https://developer.android.com/tools/sdk/ndk/index.html
|
|
- If are not using r9c+, comment the "NDK_TOOLCHAIN_VERSION := 4.8" in shell/android/jni/Application.mk and shell/android/xperia/jni/Application.mk
|
|
* Android 5.0.1 (API 21) & Android 2.3.1 (API 9)
|
|
- http://developer.android.com/sdk/installing/adding-packages.html
|
|
- note that API 9 is hidden (you must check to show obsolete in SDK manager)
|
|
* Ant
|
|
- http://ant.apache.org/
|
|
|
|
From project root directory:
|
|
```
|
|
export ANDROID_NDK=/ # Type the full path to your NDK here
|
|
|
|
cd shell/android/
|
|
|
|
android update project -p . --target "android-21"
|
|
|
|
ant debug
|
|
```
|
|
|
|
Building for iOS
|
|
----------------
|
|
Tools required:
|
|
* Latest Xcode
|
|
- https://developer.apple.com/xcode/downloads/
|
|
* An iOS device (reicast will not compile for the iOS Simulator)
|
|
* iOS 5.x ~ 7.x
|
|
* iOSOpenDev if developing without an official Apple certificate
|
|
- http://iosopendev.com/download/
|
|
|
|
From project root directory:
|
|
|
|
```
|
|
cd shell/ios/
|
|
|
|
xcodebuild -configuration Release
|
|
```
|
|
|
|
Building for Linux
|
|
------------------
|
|
|
|
The code is only currently compatible with 32bit architectures so you will need
|
|
to install 32bit libs to build reicast.
|
|
|
|
Requirements:
|
|
* build-essential
|
|
* libasound
|
|
* libegl1-mesa-dev
|
|
* libgles2-mesa-dev
|
|
* libasound2-dev
|
|
|
|
To build the project, go to shell/lin86 and run make
|
|
|
|
|
|
Translations
|
|
------------
|
|
New and updated translations are always appreciated!
|
|
All we ask is that you not use “regional” phrases that may not be generally understood.
|
|
|
|
Translations can be submitted as a pull request
|
|
|
|
|
|
Beta versions
|
|
-------------
|
|
[](https://travis-ci.org/reicast/reicast-emulator)
|
|
|
|
Official builds from the reicast ci service can be found at http://builds.reicast.com/
|
|
|
|
Additional builds (iOS & android) can be found at [angelxwind's](http://reicast.angelxwind.net/) buildbot
|
|
|
|
|
|
Donations and stuff
|
|
-------------------
|
|
Well, glad you liked the project so far!
|
|
|
|
We're currently short on hardware.
|
|
|
|
If you would like to donate some devices, get in touch at team@reicast.com.
|
|
GLES3 capable stuff, some mainstream hardware and rarities would be extremely
|
|
appreciated.
|
|
Keep in mind we're located in Greece for the most part
|
|
|
|
This has been tested/developed on
|
|
* Galaxy tab 7.0 Plus
|
|
* LG P990
|
|
* Archos 10G9
|
|
* Some Chinese tablet
|
|
* OUYA
|
|
* Various development boards
|
|
* GCW Zero
|
|
|
|
We had to buy all of these, except the GCW Zero and a BeagleBone which were
|
|
donated (Thanks! You rock!)
|
|
|
|
Apart from that, we don't accept monetary donations right now.
|
|
We also don't plan to be releasing a premium version at any store.
|
|
Most of the project has been developed by drk||Raziel (aka, skmp, drk, Raz,
|
|
etc) but it has been based on the works of multiple people. It would be
|
|
extremely unfair to charge for it and get all the credit :)
|
|
|
|
We're planning for an indiegogo campaign later on to help with sustained
|
|
development and running costs, so follow @reicastdc on twitter for updates
|
|
|
|
Other Testing
|
|
-------------
|
|
Devices tested by the reicast team:
|
|
* Apple iPhone 4 GSM Rev0 (N90AP)
|
|
* Apple iPhone 4 CDMA (N92AP)
|
|
* Apple iPod touch 4 (N81AP)
|
|
* Apple iPod touch 3G (N18AP)
|
|
* Apple iPhone 3GS (N88AP)
|
|
* Apple iPhone 5s
|
|
* Apple iPad 3
|
|
* Sony Xperia X10a (es209ra)
|
|
* Amazon Kindle Fire HD 7 (tate-pvt-08)
|
|
* Nvidia Shield portable
|
|
* Nvidia Shield tablet
|
|
* Samsung Galaxy Note 4
|
|
* LG Nexus 5
|
|
* Asus Nexus 7 (2013)
|
|
|
|
Team
|
|
----
|
|
|
|
You can check the currently active committers on [the pretty graphs page](https://github.com/reicast/reicast-emulator/graphs/contributors)
|
|
|
|
Our IRC channel is [#reicast @ chat.freenode.net](irc://chat.freenode.net/reicast).
|
|
|
|
The original reicast team consisted of drk||Raziel (mostly just writing code),
|
|
PsyMan (debugging/testing and everything else) and a little bit of gb_away
|
|
|
|
|
|
Special thanks
|
|
--------------
|
|
In previous iterations a lot of people have worked on this, notably David
|
|
Miller (aka, ZeZu), the nullDC team, friends from #pcsx2 and all over the world :)
|
|
|
|
[](https://bitdeli.com/free "Bitdeli Badge")
|
|
|