Projectmanifesten: de informatiekaart van een project

Begrippen uitgelegd

Een manifest is een bestand dat beschrijft hoe een project is ingericht. Denk aan een informatiekaart op een doos: een hulpmiddel leest wat erin zit en waar het moet beginnen.

Pliro’s .bipli-bundel bevat manifest.json, bronbestanden en eventueel projectmateriaal. Het manifest gebruikt JSON. De veldnamen zijn vaste formaatnamen, ook bij een Nederlands project.

Lees de belangrijkste labels

Veld Wat het beschrijft
name De projecttitel
entry Het bronbestand waar de uitvoering begint
syntaxLocale De brontaalcode, zoals en of nl
schemaVersion Welke versie van het projectformaat wordt gebruikt
appID De vaste identiteit voor de privégegevens van de app

Een schema bevat regels voor de structuur van een gegevensdocument. Het vertelt welke velden en waardesoorten een lezer mag verwachten. Een versie helpt hulpmiddelen herkennen welke regels gelden.

Identiteit is niet de titel

Twee projecten kunnen dezelfde titel hebben en toch andere apps zijn. Een project hernoemen maakt niet noodzakelijk een nieuwe gegevensidentiteit. In de huidige projectwerkwijze geven Opslaan als, Dupliceren en Importeren als kopie een aparte identiteit. Zo delen kopieën niet onverwacht privégegevens.

Laat de IDE het manifest normaal beheren. Verzin geen velden en vervang de identiteit niet om bij gegevens van een andere app te komen. De projectspecificatie beschrijft het ondersteunde formaat.

Leg uit waarom een startbestandsnaam en een vriendelijke projecttitel verschillende velden nodig hebben.