UniPCemu /

Filename Size Date modified Message
commonemuframework [0fb0aa1b2e4a]
2.5 KB
- Moved the root GIT files back to the root of the repository.
118 B
- Readded submodule.
13.4 KB
- Forced Android versions of UniPCemu to use Landscape mode only.
221 B
- Fixed AndroidBuild.sh path.
4.4 KB
README.md: Added instructions on using SDL2-2.0.8 and up.
804 B
- Made androidprompt.bat not use version numbers anymore.
849 B
- Modified build.bat syntax to include seperate install and replace the old install option with apk instead(as it builds an APK file).
845 B
- Added Android Makefile support.
396 B
- Added support for a profile command in the Windows androidprompt.bat to analyze the generated gmon.out file.


This README would normally document whatever steps are necessary to get your application up and running.

What is this repository for?

  • Quick summary
    • The UniPCemu x86 emulator project.
  • Version
    • Currently unused. Releases are the commit date in format YYYYMMDD_HHMM.

How do I get set up?

  • Summary of set up
  • This repository goes into a folder named UniPCEMU. Place the tools support repository(https://bitbucket.org/superfury/tools.git) parralel to this repository folder(Required for PSP builds).
  • Pull the submodules as well for it's required Makefiles and source code files.
  • Install Minimalist PSPSDK devkit(PSP, up to version 0.10.0 is compiling UniPCemu(with lots of sprintf warnings). Newer versions currently fail linking.) or Visual C++, MinGW(Windows)/MSYS2(See MSYS2.txt) or GNU C++ toolchsin(Linux).
  • Install SDL packages for the devkit, in C:\SDL for Windows(copy SDL2-2. folder contents to C:\SDL\SDL2 (and the SDL2_net folder to C:\SDL\SDL2_net), to use SDL 1.2., copy the folder contents to C:\SDL\SDL1.2.15(and the SDL_net folder to C:\SDL\SDL_net-1.2.8)), installers for MinPSPW and /mingw(SDL or SDL2).
  • For Visual C++:

    • Open the projects within the VisualC subfolders(the solution file) and compile SDL2 and SDL2main. Also compile the SDL2_net project when used(after compiling SDL2 itself).
      • Don't forget to add the paths C:\SDL\SDL2\include to both Win32 and x64 target include directories, as well as C:\SDL\SDL2\VisualC\$(Platform)\$(Configuration) to both Win32 and x64 target library directories.
    • Set the Visual C++ Local Windows Debugger to use $(TargetDir) for it's working directory, to comply with the other paths set in the project.
  • Configuration

    • Make sure there is a compile directory parallel to the project directory(projects_build\unipcemu) with a duplicate directory tree of the project repository(automatically createn by remake.bat on Windows and by the Windows/Linux when building using the Makefile).
  • Dependencies
    • See set up.
  • Adding the Android SDL2 build to the Android project(directories relative to the SDL2 root directory, e.g. SDL2-2.X.X)
    • Download the latest source code version of SDL2 from the project homepage.
    • Copy the android-project\src\org (android-project\app\src\main\java\org for SDL2.0.8+) directory to android-project/src.
    • Copy the include and src directories, as well as the Android.mk file to the android-project/jni/SDL2 folder.
  • Adding Android SDL2_net to the Android project
    • Download the latest version of SDL2_net from the project homepage.
    • Copy all c/h files and Android.mk to a newly created directory android-project\jni\SDL2_net folder.
    • Edit android-project\src\org\libsdl\app\SDLActivity.java, removing // before // "SDL2_net",.
  • Adding required Android Studio symbolic links to the Android project
    • Execute android-studio\app\src\main\generatelinks.bat from an elevated command prompt to generate the symbolic links in the folder.
  • How to run tests
    • Run the remake.bat file in the project directory(Requires tools repository) and use a PSP emulator to test(like JPCSP, which is supported by the batch file). On Windows, open the Visual C++ project, build and run.
  • Deployment instructions
    • Simply build using the devkit(Makefile command make psp/win/linux [re]build [SDL2[-static]](to (re)build SDL2 with(out) static linking)" or Visual C++, copy the executable (x86EMU.exe for windows or EBOOT.PBP for the PSP) to the executable directory, add SDL dll when needed, add disk images to use and run the executable. Setting up is integrated into the executable, and it will automatically open the BIOS for setting up during first execution. The settings are saved into a SETTINGS.INI text file.
    • To make the Android NDK use the SDL2_net library and compile with internet support, add " useSDL2_net=1" to the usual ndk-build command line or equivalent. A more simple version is using the build.bat to compile(which will automatically use the correct build with(out) SDL2_net). Otherwise, it isn't enabled/used.

Contribution guidelines

  • Writing tests
    • Undocumented
  • Code review
    • Add an issue to the issue tracker and report the change.
  • Other guidelines

Who do I talk to?

  • Repo owner or admin