Platform
Technical details of the Platform installation phase.
The Platform installation phase prepares the platform resources required by APPNETOS applications.
Platform resources are application-provided files that become part of the shared APPNETOS runtime.
The installer automatically discovers and installs these resources for every application.
Goals
The Platform installation phase has the following responsibilities:
- Discover platform installation resources.
- Install application platform files.
- Preserve existing files where appropriate.
- Allow applications to extend the shared runtime.
Platform Installation Area
Applications may provide a platform installation area.
Example:
.files/platform/
If the directory exists, it is processed automatically.
Applications without a platform installation area are skipped.
No manual registration is required.
Automatic Discovery
During installation the installer examines every discovered APPNETOS application.
For each application it checks whether a platform installation area exists.
If present, the platform resources are installed automatically.
Typical installer output:
[platform]
Source:
/var/www/appnetos/appnetos/application-two/.files/platform
Using application-provided installation area.
Installation Behaviour
The installer copies platform resources into the shared APPNETOS runtime.
Existing files are handled safely.
Files that are already up to date are skipped automatically.
Typical installation summary:
[platform]
sourceDirectories: 5
sourceFiles: 5
skippedFiles: 5
This allows repeated execution without producing duplicate files.
Supported Resources
Typical platform resources include:
- Configuration files
- Platform assets
- Static resources
- Shared runtime files
- Bootstrap resources
Applications decide which platform resources they provide.
Missing Platform Area
If an application does not provide a platform installation area, the installer continues automatically.
Typical output:
[platform]
No installation area found.
Area will be skipped.
This is considered normal behaviour.
Idempotency
The Platform installation phase is fully idempotent.
Existing resources are validated before installation.
Unchanged files are skipped automatically.
This allows the installer to be executed repeatedly without affecting an existing installation.
Error Handling
Errors occurring during platform installation immediately stop the installation process.
This prevents incomplete runtime installations.
The installer reports the application responsible for the failure.
Summary
The Platform installation phase provides:
- Automatic platform resource discovery
- Application-specific platform installation
- Safe handling of existing files
- Automatic skipping of unsupported applications
- Fully repeatable execution