Skip to content

Integrating Sandboxed Google Play

Simão Gomes Viana edited this page Feb 24, 2026 · 7 revisions

Note

Sandboxed Google Play is a set of features developed by the GrapheneOS developers and contributors, and it holds absolutely no affiliation with halogenOS. This is not an official endorsement or a definitive manual, but rather a simple integration guide for those who would rather not scavenge countless repositories for commits.

Guide

To integrate Sandboxed Google Play, first determine which branch you need. For example, if you want to integrate it for android-16.0.0_r1, use the branch android-16-sandboxedplay. Quarterly Platform Releases (QPRs) are denoted accordingly, such as android-16-qpr1-sandboxedplay. We will always base off the first tag of the release so that you can merge it without thinking too much about it.

You'll need to either merge following repositories or pick commits committed by us:

Then, you'll need to either pick following commits or apply the changes manually:

Finally, you'll need to track the following repositories. You can find the upstream in the XML as well and the branch is specified after the pound sign #:

Recommended commits

These commits are not necessary but recommended:

Updating

We will do our best to keep the latest *-sandboxedplay branch updated. This means you'll have to perform regular picks or merges to stay up to date.

Need help?

If you're having issues, please create an issue on our issue tracker.

Clone this wiki locally