En package.xml 1.0, la version était tout simplement la... version. En package.xml 2.0, la version est séparée en deux composants, la version et l'API.

La version représente la même chose qu'en package.xml 1.0. La version est validée de façon très prudente par le développeur.

La version de l'API est uniquement une information - l'installeur ne l'utilise pas. Il peut être utilisé pour un remplacement de l'heure du paquet par l'installeur. Ceci peut être utile lors de l'implémentation d'une méthode réflective comme getApiVersion(). De plus, la version de l'API est validée rapidement et ne nécessite qu'un numéro de version compatible version_compare().