📱Building on Android

Build the simulator on Android!

In Android phones and tablets with Termux installed with proot, you can comfortably build Nitrocid KS using the command line, since it's the most lightweight solution. However, you must have the prerequisites before being able to build KS.

Ubuntu 23.10 Mantic Minotaur users or later can directly download .NET 8.0 SDK from the official Ubuntu repositories without having to import the Microsoft's repositories.

You may need to manually update your Ubuntu proot distribution to either Mantic Minotaur or to Noble Numbat to be able to use .NET 8.0 SDK.

Trying to build Nitrocid KS on an ARM64 Android device (e.g. Android devices with Qualcomm Snapdragon 8 Gen 2 as SoC) with Termux emits two error messages. The first one is:

$ dotnet build
GC heap initialization failed with error 0x8007000E
Failed to create CoreCLR, HRESULT: 0x8007000E

and the second one is:

$ DOTNET_GCHeapHardLimit=1C0000000 dotnet build
(...)
error MSB6006: "csc.dll" exited with code 139.
Build FAILED.

In order to fix the first message, append the below environment variable before each dotnet build command like this:

$ DOTNET_GCHeapHardLimit=1C0000000 dotnet build

However, to fix the second message, download the fixed version of proot using this link (mirror if down) and run these commands outside the Ubuntu proot-distro environment:

# dpkg -i proot_5.1.107-50_aarch64.deb
# apt-mark hold proot

Using the command-line

If you are a hardcore command-line user or if you prefer using the command-line, follow these steps to build Nitrocid KS right from the command line:

  1. Open your terminal emulator on your work directory

  2. Execute git clone https://github.com/Aptivi/NitrocidKS.git

  3. Navigate to the cloned repository, NitrocidKS

  4. Execute dotnet restore and dotnet build

  5. After building is done, run dotnet run public/Nitrocid/Nitrocid.csproj

Last updated