mirror of
https://github.com/NixOS/mobile-nixos.git
synced 2024-12-16 11:43:21 +03:00
78 lines
1.5 KiB
Markdown
78 lines
1.5 KiB
Markdown
Mobile NixOS
|
|
============
|
|
|
|
An overlay for building stuff.
|
|
|
|
This is a work-in-progress.
|
|
|
|
|
|
WIP notes
|
|
---------
|
|
|
|
```
|
|
nix-build --argstr device asus-z00t -A all
|
|
# Maybe `nix copy ./result --to ssh://another-host`
|
|
adb wait-for-device && adb reboot bootloader
|
|
fastboot boot result # or full path
|
|
# getting adb and fastboot working is left as an exercise to the reader.
|
|
```
|
|
|
|
Alternatively, helpers under `bin` can be used. They mostly pave over
|
|
the nix CLI to provide one-liners and one-parameter helpers.
|
|
|
|
```
|
|
# Builds -A all for device_name $1
|
|
bin/build asus-z00t
|
|
```
|
|
|
|
### Booting qemu
|
|
|
|
```
|
|
bin/build qemu-x86_64 -I nixpkgs=an/unstable/(nixos-or-nixpkgs)/checkout/nixpkgs/
|
|
bin/boot-qemu
|
|
```
|
|
|
|
This currently does not build using 18.03 and may never (18.09 may release before!)
|
|
|
|
### `local.nix`
|
|
|
|
This file can be used to override (possibly with `lib.mkForce`) options on a global
|
|
scale for your local builds.
|
|
|
|
If the file does not exist, it will not fail.
|
|
|
|
A sample `local.nix`:
|
|
|
|
```
|
|
{ lib, ... }:
|
|
|
|
{
|
|
mobile.boot.stage-1.splash.enable = false;
|
|
}
|
|
```
|
|
|
|
This will disable splash screens.
|
|
|
|
This will be most useful to configure local sensitive stuff like password (hashes)
|
|
or ssh keys.
|
|
|
|
|
|
Goals
|
|
-----
|
|
|
|
The goal is to get a nix-built operating system, preferably NixOS running on
|
|
mobile devices, e.g. Android phones.
|
|
|
|
|
|
Prior work
|
|
----------
|
|
|
|
This project heavily borrows and relies on the hard work from the [PostmarketOS
|
|
project](https://postmarketos.org/).
|
|
|
|
|
|
Notes
|
|
-----
|
|
|
|
> This is an unofficial and unsanctioned project.
|