UniPCemu /

Filename Size Date modified Message
commonemuframework [b5d5e36b2d20]
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.9 KB
README.md edited online with Bitbucket
804 B
- Made androidprompt.bat not use version numbers anymore.
523 B
bitbucket-pipelines.yml: Added submodule support.
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.
    • Edit android-project/jni/SDL2/src/video/android/SDL_androidevents.c, replace "#define SDL_ANDROID_BLOCK_ON_PAUSE 1" with "#define SDL_ANDROID_BLOCK_ON_PAUSE 0" (both unquoted).
  • 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)" (alternatives to [re]build exist, like [re]profile and analyze[2]. SDL[2]_net adds network support using said libraries) or Visual C++, copy the executable (x86EMU_x[arch].exe for windows or EBOOT.PBP for the PSP) to the executable directory, add SDL libraries when needed(automatically done when using MSys/MinGW and most Makefiles), add disk images to use according to the documentation and run the executable. Setting up is integrated into the executable, and it will automatically open the Settings menu for setting up during first execution. The settings are saved into a SETTINGS.INI text file.
    • Add the mingw32/mingw64 parameter to the above command when using MSys/MinGW compilers.
    • 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. It's also an automatic process with Android Studio.

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