0
0
mirror of https://github.com/termux/proot-distro.git synced 2024-11-13 13:59:19 +00:00
proot-distro/distro-plugins/distro.sh.sample
Leonid Pliushch 4726eb81d9
initial commit for v2.0.0
@@ What is brought by new major release:

- Default distro plug-ins are immutable now.

  They are not intended to be editable by user anymore. For customization,
  users will need to make own copy. This change aims at simplifying updates
  and avoiding cases where something was not updated for unknown reason.

- Simplified distro plug-in structure.

  URLs are now retrieved from array instead of function returning values in
  specific format.

- Enforced integrity checking.

  Integrity checking is necessary to ensure that downloaded content is valid
  and not corrupted.

- No distribution versioning anymore.

  Due to numerous requests I have added versioning previously, but it appears
  bad design choice and has been a step from the original `proot-distro`
  purpose anyway. This feature is now disabled. Proot Distro won't serve
  customization requests anymore.

  If user need a custom distribution version, it should create own distro
  plug-in.

  Instead of versioned distributions only LTS, latest stable or rolling
  distribution variant will be provided.

- Added support for ArchLinux on i686 devices.

  Available as `archlinux` but really it is ArchLinux32 project.

- Added new distribution "OpenSUSE Tumbleweed".

  Available as `opensuse`.

- Own rootfs archives.

  PRoot Distro will now use own rootfs archive variants instead of the
  official.

  Script for generating tarballs is published.

- Rootfs customization is performed by distro plug-ins.

  Avoid editing /etc content during rootfs build time.

- Stabilizing design & feature set.

  It is not possible to make software suitable for everyone's needs while
  maintaining same quality. Since v2.x I will accept only feature requests
  that fit into PRoot Distro objectives and do not describe redundant
  functionality (i.e. that can be achieved through already existing).

  PRoot Distro has been intended to be simple both by design and usage.
2021-08-15 01:17:46 +03:00

34 lines
1.2 KiB
Plaintext

# Do not modify this file. All changes will be discarded on the next
# package update.
# Default value is set by proot-distro script and is equal to the CPU
# architecture of your device. You can set this to a custom value to
# force use emulation mode (QEMU user).
# Valid values are: aarch64, arm, i686, x86_64.
#DISTRO_ARCH=aarch64
# Name of distribution.
DISTRO_NAME="Example"
# Optional comment for distribution.
DISTRO_COMMENT="An introduction to proot-distro plug-ins."
# How much path components should be stripped when extracting rootfs tarball.
# The default is "1" which means to omit the root component.
TARBALL_STRIP_OPT=1
# TARBALL_URL is a Bash associative array containing rootfs URLs for specified
# CPU architectures. You must specify at least one.
TARBALL_URL['aarch64']="https://example.com/archive.tar.gz"
# SHA-256 checksum for the given tarball. You must specify checksum for each
# defined tarball.
TARBALL_SHA256['aarch64']="0000000000000000000000000000000000000000000000000000000000000000"
# This function defines any additional steps that should be executed during
# installation. You can use "run_proot_cmd" to execute a given command in
# proot environment.
distro_setup() {
run_proot_cmd touch /etc/hello-world
}