• Intro Headers Instructions Macros Commands
Fork me on GitHub
    • Getting Started
      • How to install bnd
      • Guided Tour
      • Guided Tour Workspace & Projects
      • FAQ - Frequently Asked Questions
    • Concepts and Practices
      • Introduction
      • Concepts
      • Best practices
    • Build and Development
      • Project Setup
      • Generating JARs
      • Versioning
      • Baselining
      • Service Components
      • Metatype
      • Contracts
      • Bundle Annotations
      • Accessor Properties
      • SPI Annotations
    • Dependency and Launching
      • Resolving Dependencies
      • Launching
      • Startlevels
    • Testing
      • Testing
      • Testing with Launchpad
    • Packaging and Distribution
      • Packaging Applications
      • JPMS Libraries
      • Wrapping Libraries to OSGi Bundles
    • Documentation and Tools
      • Generating Documentation
      • Commands
      • For Developers
      • Templates for Workspaces
      • Tips for Windows users
      • Tools bound to bnd
    • Reference Material
      • Reference
      • Headers
      • Instruction Reference
      • Instruction Index
      • Macro Reference
      • Macro Index
      • Plugins
      • External Plugins
    • Configuration and Troubleshooting
      • Settings
      • Errors
      • Warnings
  • -launcher
    Project

    Options for the runtime launcher

    This instruction has as purpose to collect options and special settings for the launcher. The following options are architected:

    • manage – Indicates to the launcher how to treat unrecognized bundles. When the launcher starts it gets a list of run bundles, also called its scope. However, previous runs could’ve installed other bundles that do not occur in the scope. By default the launcher should manage all bundles. However, sometimes these bundles were installed by an agent and the launcher should not touch them. Therefore the values for the ‘manage’ part are:
      • all – This is the default and the launcher assumes it owns all the bundles
      • narrow – The launcher will only touch the bundles that are part of its scope
      • none – The launcher should defer from managing any bundles.

    Example

    -launcher manage = all  
    

    Background

    This instruction was primarily designed to handle start levels. Originally the launcher was narrowly managing only the bundles that were in its scope. However, this was inadvertently changed and not discovered for several reasons. The option to narrowly manage was therefore introduced with the default being the latest behavior.

Search
    • Home