Native Android Application Execution on macOS

📱 Overview

Mac.apk is a specialized compatibility layer designed to run Android applications natively on Apple Silicon hardware. Rather than relying on heavy virtualization, it allows apps to function as standard macOS processes.

Key Characteristics

• Performance: Apps execute at native CPU speeds and utilize the Mac's GPU for rendering.
• Integration: Android apps appear in the Dock, support standard window resizing and rotation, and automatically toggle between Light and Dark modes.
• UI Nuances: Each window includes a dedicated "back" button situated next to the standard macOS traffic light controls.

What it is NOT

To understand Mac.apk, it is helpful to see what it avoids:

• No background Android booting
• No underlying Linux kernel
• No instruction-by-instruction interpretation

Instead, it implements the Android environment directly atop macOS.

---

🛠️ Technical Specifications & Requirements

System Compatibility

Compatibility Status

The project is stable and evolving. Current testing metrics:

• Total Apps Tested: 65
• Fully Functional: 51
• Partial Functionality: 10
• Not Yet Working: 4

---

🚀 Getting Started

Installation Checklist

• Download the disk image from the Releases section.
• Move Mac.apk into your /Applications folder.
• Launch the app and click Install next to the Runtime: label.
• Navigate to Settings (gear icon) $\rightarrow$ File types $\rightarrow$ Make Default.
• Confirm the macOS system prompt.

Running Apps

You can launch apps by double-clicking files with the following extensions: .apk, .apkm, .xapk, .apks, or .apkx. Alternatively, simply drag the file onto the Mac.apk window.

[!IMPORTANT] Initial Launch Delay: The first time you open an app, it may take up to a minute to prepare (especially for larger files).

[!WARNING] Data Persistence: Android app data is stored within its own .app bundle. If you drag the app to the Trash, you will lose your save data. To safely remove an app, use the Mac.apk control panel.

---

💻 Developer & Contributor Information

The Architecture

The source code is fully available in the repository and comprises:

1. The Android framework reimplementation.
2. The native runtime.
3. The arm64 loader and Bionic shim.
4. The ARM32 recompiler.
5. The macOS wrapper application.

For build instructions, refer to BUILDING.md; for contribution guidelines, see CONTRIBUTING.md.

Publisher Policy

By design, Mac.apk does not support in-app purchases or advertisements. Publishers wishing to discuss partnerships or request the removal of their app should contact Kaleb@voltare.us.

Licensing

• Open Source: Distributed under the GNU AGPL v3.0.
• Commercial: A separate commercial license is available for corporate entities.
• Branding: See TRADEMARKS.md for logo and name usage.

---

⚠️ Security & Legal Disclaimer

Mac.apk is provided "as is" without warranty.

Because an Android app runs as native code under your macOS user account, there is no phone-style sandbox. The app possesses the same read/write permissions as any other native Mac application.

# Example: App logs are located here for troubleshooting
~/Library/Logs/macapk/

User Responsibility:

• You are solely responsible for the APKs you install.
• Voltare does not audit third-party APKs.
• Voltare is not liable for malware, data loss, or copyright disputes.
• Recommendation: Only install APKs from sources you trust implicitly.

Third-Party Components

Mac.apk integrates several open-source libraries, including:

• ANGLE, MoltenVK, and the Vulkan loader
• Capstone, libpng, libvpx, stb_vorbis
• Bouncy Castle
• A JRE derived from OpenJDK (including FreeType, HarfBuzz, and GLib)
• AOSP-sourced Android platform resources

Full attribution is available in THIRD_PARTY_NOTICES.txt.

---

🆘 Support

To report a bug, please email Kaleb@voltare.us or open a GitHub issue with the following:

1. Mac.apk version.
2. macOS version.
3. The app name and its source.
4. A description of the issue.
5. The log file from ~/Library/Logs/macapk/.