Android port (OpenXcom) - Revision history

Hobbes: Undo revision 126415 by Hobbes (talk)

2026-03-10T14:59:48Z

Undo revision 126415 by Hobbes (talk)

Hobbes: Removed protection from "Android port (OpenXcom)"

2026-03-10T14:47:41Z

Removed protection from "Android port (OpenXcom)"

← Older revision	Revision as of 14:47, 10 March 2026
(No difference)

Hobbes: Protected "Android port (OpenXcom)" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

2026-03-10T13:56:24Z

Protected "Android port (OpenXcom)" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

← Older revision		Revision as of 13:56, 10 March 2026
(No difference)

Hobbes: Redirected page to OpenXcom

2026-03-10T13:56:17Z

Redirected page to OpenXcom

Show changes

Sfalexrog: Add newer Android port instructions

2015-12-01T18:04:00Z

Add newer Android port instructions

← Older revision		Revision as of 18:04, 1 December 2015
Line 1:		Line 1:
	=v1.0=		=Current version=

			Currently, the ongoing development is split in two parts. First, there's the [https://github.com/sfalexrog/OpenXcom/tree/sdl2 SDL 2 branch] of OpenXcom, which is basically OpenXcom ported to SDL2, with a few platform-specific #ifdefs thrown here and there. Then, there's the "one-click-build" [https://github.com/sfalexrog/openxcom-android Android Studio project] with Android-specific stuff and submodules for dependencies. The project is (ir)regularly updated to be up-to-date with the current OpenXcom version.

			==Installing==

			The application is now a lot more user-friendly and doesn't require OpenXcom data from your PC. You still need the '''X-Com: Enemy Unknown''' and/or '''Terror From The Deep''' data files on your device.

			Installation now goes like this:

			* Copy your '''X-Com: Enemy Unknown'''/'''Terror From The Deep''' files to a folder on your device. Each game should be in a separate folder!
			* Install the .apk on your device. You will need to enable installing apps from unknown sources.
			* Run the app. It will display a first-time configuration menu. There you might want to change your data/savefiles/configuration folders. After you've done that, tap one of the "Copy UFO/TFTD data from directory..." and navigate to the folder containing the game data (folders like GEODATA, GEOGRAPH, MAPS, ROUTES). If done correctly, the data will be copied to your game folder, and the "Status: " will become green and will contain a version string.
			* And that's it! You're ready to go.

			==Building==

			You'll need a recent Android SDK, Android NDK r10d+ (currently built using r10e), JDK 7+.

			* Checkout the [https://github.com/sfalexrog/openxcom-android Android Studio project]
			* Init submodules (git submodule init, git submodule update)
			* Create a local.properties file in the project root and put sdk.dir= and ndk.dir= properties there (pointing to your Android SDK and NDK respectively)
			* Run gradlew assemble

			Some more specific instructions are on the [https://github.com/sfalexrog/openxcom-android Android Studio project] page itself.

			=v1.0 (outdated)=

	There is a work-in-progress port to Android of OpenXcom here: [https://github.com/sfalexrog/OpenXcom/ github link]		There is a work-in-progress port to Android of OpenXcom here: [https://github.com/sfalexrog/OpenXcom/ github link]

Sfalexrog at 16:30, 14 June 2014

2014-06-14T16:30:08Z

@@ Line 8: / Line 8: @@
 * Copy the contents of your data folder from PC/Mac to /sdcard/OpenXcom/data on your device.
 * That's it! You're good to go.
 =v0.9=

SupSuper at 15:59, 14 June 2014

2014-06-14T15:59:20Z

← Older revision		Revision as of 15:59, 14 June 2014
Line 1:		Line 1:
	There is a work-in-progress port to Android of OpenXcom here: [https://github.com/~~cpages~~/OpenXcom/~~tree/android~~ github link]		=v1.0=

			There is a work-in-progress port to Android of OpenXcom here: [https://github.com/sfalexrog/OpenXcom/ github link]

	=Installation instructions=		==Installation instructions==
	* Install OpenXcom on your PC/Mac and make sure it's working. You'll need original data for this step.		* Install OpenXcom on your PC/Mac and make sure it's working. You'll need original data for this step.
	* Get the OpenXcom apk from the [http://openxcom.org/downloads/ official site] or [http://openxcom.org/forum/index.php?topic=1864 android port forum thread] and install it on your device. Note that the builds in the forum thread are signed with a debug certificate, so you'll need to uninstall first if you're coming from an earlier build.		* Get the OpenXcom apk from the [http://openxcom.org/downloads/ official site] or [http://openxcom.org/forum/index.php?topic=1864 android port forum thread] and install it on your device. Note that the builds in the forum thread are signed with a debug certificate, so you'll need to uninstall first if you're coming from an earlier build.
Line 7:		Line 9:
	* That's it! You're good to go.		* That's it! You're good to go.

	=I just want to play=		=v0.9=

			There is a work-in-progress port to Android of OpenXcom here: [https://github.com/cpages/OpenXcom/tree/android github link]

			==I just want to play==
	Ok, so if you're too lazy to build it ;) and just want to give it a try, here are the steps you should follow:		Ok, so if you're too lazy to build it ;) and just want to give it a try, here are the steps you should follow:
	* Get the beta3 apk [http://openxcom.org/download/mobile/OpenXcom-v0.9-beta3.apk from here] and install (you'll have to trust me on this, but it only asks for filesystem access)		* Get the beta3 apk [http://openxcom.org/download/mobile/OpenXcom-v0.9-beta3.apk from here] and install (you'll have to trust me on this, but it only asks for filesystem access)
Line 14:		Line 20:
	* Another, easier way to get the proper data would be to install the desktop version of OpenXcom, then copy the contents of its data folder to /sdcard/openxcom/data. Note that you STILL need the original data during the desktop OpenXcom installation.		* Another, easier way to get the proper data would be to install the desktop version of OpenXcom, then copy the contents of its data folder to /sdcard/openxcom/data. Note that you STILL need the original data during the desktop OpenXcom installation.

	=Building from sources (linux)=		==Building from sources (linux)==
	So you're in for the hard route. It's been a while since I set up my build env so I might miss some detail, but I'll try to give an overview of how to build and point out the main caveats you may encounter:		So you're in for the hard route. It's been a while since I set up my build env so I might miss some detail, but I'll try to give an overview of how to build and point out the main caveats you may encounter:
	* Install android sdk & ndk		* Install android sdk & ndk
Line 40:		Line 46:
	* If you have your android device plugged in, 'ant debug install'		* If you have your android device plugged in, 'ant debug install'

	=Differences with PC version (battlescape)=		==Differences with PC version (battlescape)==
	* Path preview is enabled by default		* Path preview is enabled by default
	* Shoot works in the same way as path preview, first press to aim, second to shoot		* Shoot works in the same way as path preview, first press to aim, second to shoot
Line 47:		Line 53:
	* Swipe from selected soldier to make him turn and open doors		* Swipe from selected soldier to make him turn and open doors

	=Known issues=		==Known issues==
	* Don't leave the game while in text enter mode. When going back, it won't reappear and you'll be stuck editing the text.		* Don't leave the game while in text enter mode. When going back, it won't reappear and you'll be stuck editing the text.
	* On a few devices, the colors appear wrong (shades of pink). It can be worked around by disabling the 'hardware overlay' in 'developer settings'		* On a few devices, the colors appear wrong (shades of pink). It can be worked around by disabling the 'hardware overlay' in 'developer settings'

	=Changelog=		==Changelog==
	* beta3 (13/05/14)		* beta3 (13/05/14)
	** Update to upstream 9d292a2a82		** Update to upstream 9d292a2a82
Line 68:		Line 74:
	** [https://drive.google.com/file/d/0B3hKlvL6jSs8Rkpla0s3SGJYSEk data + music]		** [https://drive.google.com/file/d/0B3hKlvL6jSs8Rkpla0s3SGJYSEk data + music]

	=Contact=		==Contact==
	You can post on the [http://openxcom.org/forum/index.php?topic=1864.0 forum thread] or try to reach me on irc channel openxcom@freenode (nick 'page').		You can post on the [http://openxcom.org/forum/index.php?topic=1864.0 forum thread] or try to reach me on irc channel openxcom@freenode (nick 'page').

	[[Category:OpenXcom]]		[[Category:OpenXcom]]

Sfalexrog at 15:39, 14 June 2014

2014-06-14T15:39:27Z

← Older revision		Revision as of 15:39, 14 June 2014
Line 1:		Line 1:
	There is a work-in-progress port to Android of OpenXcom here: [https://github.com/cpages/OpenXcom/tree/android github link]		There is a work-in-progress port to Android of OpenXcom here: [https://github.com/cpages/OpenXcom/tree/android github link]

			=Installation instructions=
			* Install OpenXcom on your PC/Mac and make sure it's working. You'll need original data for this step.
			* Get the OpenXcom apk from the [http://openxcom.org/downloads/ official site] or [http://openxcom.org/forum/index.php?topic=1864 android port forum thread] and install it on your device. Note that the builds in the forum thread are signed with a debug certificate, so you'll need to uninstall first if you're coming from an earlier build.
			* Copy the contents of your data folder from PC/Mac to /sdcard/OpenXcom/data on your device.
			* That's it! You're good to go.

	=I just want to play=		=I just want to play=

Sfalexrog: /* I just want to play */

2014-06-14T15:26:16Z

I just want to play

← Older revision		Revision as of 15:26, 14 June 2014
Line 6:		Line 6:
	* Get the [http://openxcom.org/download/mobile/data-9d292a2a82.zip OpenXcom data]. Unzip all of this in your phone under /storage/sdcard0/openxcom (you should have a /sdcard simlink, so /sdcard/openxcom should work too). If you have an external sd card, you can also place it there (/storage/extSdCard/openxcom).		* Get the [http://openxcom.org/download/mobile/data-9d292a2a82.zip OpenXcom data]. Unzip all of this in your phone under /storage/sdcard0/openxcom (you should have a /sdcard simlink, so /sdcard/openxcom should work too). If you have an external sd card, you can also place it there (/storage/extSdCard/openxcom).
	* You also need a copy of the original data (you can get that in many places if you don't have it, like steam). Copy the following folders in the same place (/sdcard/openxcom/data): GEODATA GEOGRAPH MAPS ROUTES SOUND TERRAIN UFOGRAPH UFOINTRO UNITS		* You also need a copy of the original data (you can get that in many places if you don't have it, like steam). Copy the following folders in the same place (/sdcard/openxcom/data): GEODATA GEOGRAPH MAPS ROUTES SOUND TERRAIN UFOGRAPH UFOINTRO UNITS
			* Another, easier way to get the proper data would be to install the desktop version of OpenXcom, then copy the contents of its data folder to /sdcard/openxcom/data. Note that you STILL need the original data during the desktop OpenXcom installation.

	=Building from sources (linux)=		=Building from sources (linux)=

Page: Updated forum post link

2014-05-20T10:38:58Z

Updated forum post link

← Older revision		Revision as of 10:38, 20 May 2014
Line 62:		Line 62:

	=Contact=		=Contact=
	You can post on the [http://openxcom.org/forum/index.php?topic=~~150~~.0 forum thread] or try to reach me on irc channel openxcom@freenode (nick 'page').		You can post on the [http://openxcom.org/forum/index.php?topic=1864.0 forum thread] or try to reach me on irc channel openxcom@freenode (nick 'page').

	[[Category:OpenXcom]]		[[Category:OpenXcom]]