AndroidRecomp - GitLite

KO | EN

gitlite — search

#chatgpt #kubernetes #database #vue #awesome #hacktoberfest #git #proxy #golang #tensorflow

AndroidRecomp

(★ 16)

A profile-driven ARMv7 Android-to-Windows compatibility runtime for native games.

File Explorer

ZIP Download

- - bug_report.yml
  - config.yml
- - validate.yml
- __init__.py
- cli.py
- upstream.py
- workspace.py
- architecture.md
- porting-guide.md
- profile-format.md
- - patches.py
  - profile.json
- fetch_upstream.py
- import_pvz2native.py
- prepare_profile.py
- - README.md
.editorconfig
.gitattributes
.gitignore
CHANGELOG.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
import-pvz2native.bat
LICENSE
MANIFEST.sha256
pyproject.toml
README.md
SECURITY.md
THIRD_PARTY_NOTICES.md
upstream.lock.json

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`python`

View Details ▼

Python language interpreter.

python

Start a REPL (interactive shell):

python {{path/to/file.py}}

Execute a specific Python file:

python -i {{path/to/file.py}}

Execute a specific Python file and start a REPL:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

I am not a specialized developer, and I don't have the time to maintain the project. Don't expect anything amazing to come of this. This project is the result of work by people far more talented than I am. Credits are at the bottom of the page.

# Recompiled games
So far, I have recompiled the following games:
[Backstab](https://github.com/jessicanataliagta/BackStabRecomp/releases)

# AndroidRecomp

AndroidRecomp is a profile-driven porting framework for native **ARMv7 Android games**. It prepares a minimal Android-like runtime, maps original ELF shared objects into a guest address space, executes ARM code through dynamic recompilation, and lets each game profile provide the JNI, filesystem, graphics, audio, input, and lifecycle behavior required by that title.

AndroidRecomp is **not** a full Android emulator, an APK compatibility layer, or a universal one-click porting tool. Every game requires a dedicated profile and may need engine-specific fixes.

## Backend source modes

The default backend is pinned to `OptiJuegos/PvZ2Native` commit `15dbe5c2dee7b4a73f0803127bb8bad9a32c8406`. Source resolution follows this order:

1. complete source tree in `vendor/PvZ2Native`;
2. pinned ZIP in `vendor/PvZ2Native-15dbe5c2dee7b4a73f0803127bb8bad9a32c8406.zip`;
3. local cache under the game project;
4. pinned download from the original repository.

Import a local checkout or GitHub source ZIP with:

```bat
import-pvz2native.bat "C:\Path\To\PvZ2Native-or-source.zip"
```

The complete unmodified upstream snapshot is not physically embedded in this generated package because it could not be materialized in the packaging environment. The importer and vendored-source runtime path are fully included, so the source can be added locally before the private repository is published.

## Repository layout

```text
AndroidRecomp/
├── androidrecomp/          Profile and workspace preparation package
├── docs/                   Architecture and porting documentation
├── profiles/template/      Minimal profile template
├── tools/                  Validation and source-import tools
├── vendor/PvZ2Native/      Optional embedded backend source tree
├── upstream.lock.json      Pinned backend revision and source locations
├── PRE_PUBLICATION.md      Publication gate for the private edition
└── LICENSE                 AndroidRecomp-owned files only
```

## Quick start

Place AndroidRecomp and a game repository next to each other:

```text
Projects/
├── AndroidRecomp/
└── BackstabRecomp/
```

From the game repository:

```bat
bootstrap.bat
build-msvc.bat
```

The equivalent direct command is:

```bash
python -m androidrecomp.cli prepare \
  --profile ../BackstabRecomp/profile.json \
  --project-root ../BackstabRecomp
```

## Scope

Reusable runtime preparation, workspace management, profile loading, common CMake compatibility, and generic documentation belong in AndroidRecomp. Game symbols, package names, JNI methods, asset aliases, input regions, and engine patches belong in game-profile repositories.

## Project status

AndroidRecomp is an early developer framework. BackstabRecomp is the first profile. APIs may change until additional game profiles validate the abstractions.

## Legal

AndroidRecomp contains no commercial game executable, APK, OBB, game asset, encryption key, account token, or license-bypass component. Read.

## Credits

This project is heavily based on the PvZ2Native project.
Their team is composed by: OptiJuegos, staFF6773, and Eliandro4.