Skip to content

Commit

Permalink
docs: add addon-development doc and properly link EthernetManager doc
Browse files Browse the repository at this point in the history
  • Loading branch information
electrikjesus committed Mar 24, 2024
1 parent b86d6da commit 605221d
Show file tree
Hide file tree
Showing 4 changed files with 52 additions and 0 deletions.
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ icon: home
## Development

* [Building Bass OS](development/building-bass.md)
* [Addon Development](development/addon-development.md)
* [Development FAQ](development/development-faq.md)
* [Maintaining Proper Authorship](development/maintaining-proper-authorship.md)
* [Contributing Documentation](development/contributing-documentation.md)
Expand Down
50 changes: 50 additions & 0 deletions development/addon-development.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
## Addon Development

Learning our addon development process will give you a good concept of how things are put together.

Let's say that you have a change that you want to add to Bass OS, but that change can be used on many devices, so you don't want to keep it as a private change that is never shared outside this single devices source. This is where Addons come into play.

Addons can consist of one or more of the following:

* Patchsets - Single or multiple sets of patches that are to be applied on-top of the source when unfolding the OS.
* Prebuilt APK's - An example of this is the Restricted Launcher Pro. We offer the free version of the prebuilt for all to include, but it contains branding that cannot be changed. But we offer the Pro version that can be rebranded and further customized as an addon.
* Package/External Sources - An example of this is our Kiosk Launcher, as that requires the private source to be included in the OS in order to use it.
* Script Addon - An automation script that does something or helps automate any point in the build process.

### Patchset Addon Development

The first example we will go over is for a patchsett based addon. For this, you will use a patches folder with a name following the addon_name. Along with a manifest .xml that links your addon as a .git. This will allow you to have a private repo as an addon and control access to it if needed.

#### Example patchset addon

We have an example patchset addon for a change that can be found in `/bigblissdrive03/bass-wg01/assets/examples/addon_templates/patchsets-network_options`. Take a look at the README.md for that to get a good idea of the info we include as a starting point.

#### Where things go

When syncing the Bass OS project, you will want to place the patchset addon folder (`patchsets-addon_name`) in the `private/addons/` folder. This location will be searched when the project is unfolded, and any manifest file found will be synced in the unfolding process. After sync is complete, any patches that are required for the addon will be automatically applied.

##### Manifest

The manifest file should point to the path: `vendor/bass/patches/patchsets-addon_name`. You should also name the manifest file the unique name of your addon. The remote name defined within the manifest .xml should also be unique to your addon.

##### Patchset

The patchset should be organized in multiple folders within the `addon_name` folder of your addon.

Example:
- patchsets_addon_name
- README.md
- manifest
- private-addon_name.xml
- addon_name
- device
- generic
- common
- 0001-change_name-1-of-3.patch
- bootable
- newinstaller
- 0001-change_name-2-of-3.patch
- recovery
- 0001-change_name-3-of-3.patch


1 change: 1 addition & 0 deletions interfaces/BlissEthernetManager
File renamed without changes.

0 comments on commit 605221d

Please sign in to comment.