APPNETOS is under active development This website and its documentation are being prepared for public launch. Content and features may change.
Select Theme
Loading

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

Next Steps

Previous

Environment

Go to Environment

Next

Public

Go to Public