
Andrew Hanna

Andrew Hanna

TL;DR: Een unmanaged package in Salesforce is een eerste-generatiebundel van metadata die je één keer installeert en daarna volledig bezit: elk component wordt aanpasbaar in de doel-org, er is geen namespace, geen IP-bescherming en geen upgradepad. Het is het juiste middel voor sjablonen, voorbeeldapps en eenmalige overdrachten. Voor alles wat je wilt onderhouden, stap je over op een unlocked package.
Een unmanaged package is een eenmalig distributiemechanisme. Je verzamelt componenten zoals custom objects, velden, Apex-klassen, flows, layouts en rapporten, uploadt ze vanuit een packaging-org en deelt een installatielink. Bij installatie worden de onderdelen in de doel-org uitgepakt en gedragen ze zich alsof een admin ze daar zelf heeft gebouwd.
Dat is de hele afweging. De installateur krijgt volledige controle, en de uitgever geeft elke mogelijkheid op om later fixes te pushen. Voor een vergelijking van beide modellen, zie managed versus unmanaged packages in Salesforce.
Komen de woorden versie, upgrade of subscriber ergens in je plan voor, dan is een unmanaged package de verkeerde keuze.
De regel deïnstalleren-om-te-upgraden is waar teams data verliezen. Leg een bekende goede staat vast voordat je een geïnstalleerd package verwijdert. In Serpent doet de Backups-weergave precies dat: ze herstelt ondersteunde org-metadata en records en houdt een Restore History bij. Dit vult rollback aan, en reeds verwijderde data blijft lastiger netjes terug te draaien, dus maak eerst een back-up. De stappen staan in de gids voor back-up en herstel.
Dit deel laten de meeste gidsen weg. Er is geen conversie ter plekke, dus je bouwt het package opnieuw op vanuit source:
package.xml voor
die componenten en voer
sf project retrieve start --manifest package.xml --target-org source
uit. Onze
gids voor Salesforce CLI
behandelt de opzet.
sf package create --package-type Unlocked --path force-app uit tegen je
Dev Hub en maak daarna een versie met
sf package version create --code-coverage. Apex heeft minstens 75%
dekking nodig voordat je kunt promoten.
Voor stap 6 vult Serpent voorbeeld- of gemaskeerde data tijdens het opzetten van omgevingen en in releasepipelines, zodat scratch orgs en ververste sandboxes gevuld terugkomen zonder handmatig script. Bouw je voor AppExchange, dan is de bestemming een managed 2GP-package; lees dan eerst de geheimen van second-generation managed packages.
De ondersteuning voor package development in Serpent bouwt, versioneert en levert 1GP-, 2GP- en managed packages op elk plan, en brengt afhankelijkheden in kaart zodat versieconflicten opduiken voordat een doel-org ze ziet. Meer how-to's vind je in onze SF Guides.
Kun je een unmanaged package upgraden?
Nee. Je moet de oude versie deïnstalleren en de nieuwe installeren, waarbij de data in de custom objects en velden verdwijnt.
Hebben unmanaged packages een namespace?
Nee. Componenten worden in de standaard-namespace geïnstalleerd, en daarom zijn naamconflicten mogelijk.
Kan ik een unmanaged package op AppExchange aanbieden?
Nee. Commerciële distributie via AppExchange gebruikt managed packages, met een namespace en een doorlopen security review.
Kan ik een unmanaged package omzetten naar een unlocked package?
Niet ter plekke. Haal de metadata op naar versiebeheer en maak daaruit een nieuw unlocked package.
Vrijblijvend.