Adding Debian packages: Difference between revisions

From Variscite Wiki
No edit summary
 
(22 intermediate revisions by 3 users not shown)
Line 1: Line 1:
--> {{#vardefine:RELEASE_PARAM|{{#urlget:release}}}} <!--
<!-- Set release according to "release" parameter in URL and use RELEASE_BUSTER_V1.0_DART-MX8M-MINI as default
--> {{#lst:Debian_Platform_Customization|{{#var:RELEASE_PARAM|RELEASE_BUSTER_V1.0_DART-MX8M-MINI}}}} <!--
--> {{INIT_RELEASE_PARAM|RELEASE_BUSTER_V1.0_DART-MX8M-MINI}} <!--
--> {{#lst:Debian_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
--> {{PageHeader|{{#var:HARDWARE_NAME}} - Adding Debian Packages}} {{DocImage|category1={{#var:HARDWARE_NAME}}|category2=Debian}} __toc__
--> {{PageHeader|{{#var:HARDWARE_NAME}} - Adding Debian Packages}} {{DocImage|category1={{#var:HARDWARE_NAME}}|category2=Debian}} __toc__
= General =
= General =
We don't recommend duplicating eMMC / clone from one device to another.  
It's not recommended to duplicate/clone SOM's internal storage from one device and attach it to another. There are few scripts run for the first time at startup, and configuration files are generated, which are unique to the SOM. A better approach is to add required packages, services, and applications to the Debian rootfs at compile time using the build script. The resulting rootfs, created by the build script, will then be available as an archive, ready to be deployable for other targets.  
There are few scripts that run at the first time at startup and configuration files are generated which are unique to the SOM.  


== Adding Packages to rootfs ===
Please refer to the {{Varlink2|Debian Build Release|{{#var:RELEASE_LINK}}}} guide to learn more about the build process.
If you have packages, add your list of packages to build script,  while building roofs.  
For example, below git and vim <br>
install git, and vim set the line to <br>
readonly G_USER_PACKAGES="git vim" <br>


== Adding Application to rootfs
== Adding packages to rootfs ==
If you have your application to be installed on your rootfs: <br>
If you want to add more packages to the Debian rootfs, add your list of packages to the build script variable ''G_USER_PACKAGES'' (already present in the build script).
Take https://github.com/varigit/debian-var/blob/debian_buster_var01/variscite/weston_rootfs.sh#L295 <br>
lines as an example and install your applications, config files / settings etc. <br>
Don't forget to copy your resources to variscite folder.<br>


For example, if you want to add the packages '''git''' and '''vim''', you can change


== Build the rootfs ===
<pre>
Follow :
#### user rootfs packages ####
readonly G_USER_PACKAGES=""
</pre>
 
to
 
<pre>
#### user rootfs packages ####
readonly G_USER_PACKAGES=" \
git \
vim \
"
</pre>
''File: {{#var:BUILD_FOLDER}}/var_make_debian.sh''<br>
<br>
{{Note|'''Note:''' You can look up the available packages for Debian {{#var:DEBIAN_NAME}} at the [https://www.debian.org/distrib/packages.en.html Debian packages directory].|info}}
 
== Adding application to rootfs ==
If you have your application to be installed on your rootfs, you can add your application files (e.g., binaries, libraries, service and configuration files) to the 'variscite' folder (located in the root of the build folder: {{#var:BUILD_FOLDER}}/variscite) and add the installation routine to the build script.<br><br>
Take the forth-stage section of the following script as an example (search for "# fourth-stage" in the script): https://github.com/varigit/debian-var/blob/debian_buster_var01/variscite/weston_rootfs.sh <br>
 
In this stage, the build script installs, for example, the service '''variscite-bt''' (search for "# install variscite-bt service") by copying its application files (located at the 'variscite' folder) to their proper places in the rootfs.
 
== Build the rootfs ==
Please refer to the {{varlink|Debian_Build_Release|{{#var:RELEASE_PARAM}}|Debian Build Release guide}} to learn how to use the Debian build script to create the rootfs.

Latest revision as of 19:25, 10 May 2023

Warning: This page is designed to be used with a 'release' URL parameter.

This page is using the default release RELEASE_BUSTER_V1.0_DART-MX8M-MINI.
To view this page for a specific Variscite SoM and software release, please follow these steps:

  1. Visit variwiki.com
  2. Select your SoM
  3. Select the software release
DART-MX8M-MINI - Adding Debian Packages

General

It's not recommended to duplicate/clone SOM's internal storage from one device and attach it to another. There are few scripts run for the first time at startup, and configuration files are generated, which are unique to the SOM. A better approach is to add required packages, services, and applications to the Debian rootfs at compile time using the build script. The resulting rootfs, created by the build script, will then be available as an archive, ready to be deployable for other targets.

Please refer to the Debian Build Release guide to learn more about the build process.

Adding packages to rootfs

If you want to add more packages to the Debian rootfs, add your list of packages to the build script variable G_USER_PACKAGES (already present in the build script).

For example, if you want to add the packages git and vim, you can change

#### user rootfs packages ####
readonly G_USER_PACKAGES=""

to

#### user rootfs packages ####
readonly G_USER_PACKAGES=" \
	git \
	vim \
	"

File: ~/var_mx8mm_dart_debian_buster/var_make_debian.sh

Note: You can look up the available packages for Debian Buster at the Debian packages directory.

Adding application to rootfs

If you have your application to be installed on your rootfs, you can add your application files (e.g., binaries, libraries, service and configuration files) to the 'variscite' folder (located in the root of the build folder: ~/var_mx8mm_dart_debian_buster/variscite) and add the installation routine to the build script.

Take the forth-stage section of the following script as an example (search for "# fourth-stage" in the script): https://github.com/varigit/debian-var/blob/debian_buster_var01/variscite/weston_rootfs.sh

In this stage, the build script installs, for example, the service variscite-bt (search for "# install variscite-bt service") by copying its application files (located at the 'variscite' folder) to their proper places in the rootfs.

Build the rootfs

Please refer to the Debian Build Release guide to learn how to use the Debian build script to create the rootfs.