Els plugins són una part fonamental de l'ecosistema d'Apache Cordova. Permeten accedir a les funcionalitats natives del dispositiu des de JavaScript, ampliant així les capacitats de les aplicacions web per convertir-les en aplicacions mòbils completes.

Un plugin de Cordova és un component que proporciona una interfície JavaScript per accedir a les funcionalitats natives del dispositiu, com ara la càmera, el GPS, l'emmagatzematge, etc. Els plugins són essencials per a la majoria de les aplicacions mòbils, ja que permeten interactuar amb el maquinari i altres serveis del dispositiu.

1. Plugins oficials de Cordova: Mantinguts per l'equip de Cordova i la comunitat.
2. Plugins de tercers: Creats per desenvolupadors externs i disponibles a través de repositoris com npm.
3. Plugins personalitzats: Creats per satisfer necessitats específiques que no cobreixen els plugins existents.

Per instal·lar un plugin, utilitzarem la línia de comandes de Cordova. Per exemple, per instal·lar el plugin de la càmera:

1. Instal·lació del plugin:

   cordova plugin add cordova-plugin-camera
   

2. Ús del plugin en el codi JavaScript:

   document.addEventListener("deviceready", function() {
       document.getElementById("takePhotoButton").addEventListener("click", takePhoto);
   });
   
   function takePhoto() {
       navigator.camera.getPicture(onSuccess, onFail, {
           quality: 50,
           destinationType: Camera.DestinationType.DATA_URL
       });
   }
   
   function onSuccess(imageData) {
       var image = document.getElementById('myImage');
       image.src = "data:image/jpeg;base64," + imageData;
   }
   
   function onFail(message) {
       alert('Failed because: ' + message);
   }
   

   Explicació del codi:

   • document.addEventListener("deviceready", ...): Assegura que el dispositiu està llest abans d'accedir a les funcionalitats natives.
   • navigator.camera.getPicture(...): Obre la càmera del dispositiu i captura una foto.
   • onSuccess(imageData): Funció de callback que s'executa si la captura és exitosa. Assigna la imatge capturada a un element <img>.
   • onFail(message): Funció de callback que s'executa si hi ha un error en la captura de la foto.

Per veure quins plugins estan instal·lats en el teu projecte Cordova, utilitza:

Per eliminar un plugin del teu projecte, utilitza:

1. Instal·la el plugin de la vibració:

   cordova plugin add cordova-plugin-vibration
   

2. Crea un botó que faci vibrar el dispositiu durant 1 segon:

   <button id="vibrateButton">Vibrar</button>
   

   document.addEventListener("deviceready", function() {
       document.getElementById("vibrateButton").addEventListener("click", function() {
           navigator.vibrate(1000);
       });
   });
   

1. Instal·la el plugin de la geolocalització:

   cordova plugin add cordova-plugin-geolocation
   

2. Mostra la ubicació actual del dispositiu en un element HTML:

   <button id="getLocationButton">Obtenir Ubicació</button>
   <p id="location"></p>
   

   document.addEventListener("deviceready", function() {
       document.getElementById("getLocationButton").addEventListener("click", function() {
           navigator.geolocation.getCurrentPosition(onSuccess, onError);
       });
   });
   
   function onSuccess(position) {
       var locationElement = document.getElementById('location');
       locationElement.innerHTML = 'Latitud: ' + position.coords.latitude + '<br>' +
                                   'Longitud: ' + position.coords.longitude;
   }
   
   function onError(error) {
       alert('Error: ' + error.message);
   }
   

Els plugins de Cordova són una eina poderosa per accedir a les funcionalitats natives del dispositiu des de JavaScript. En aquest tema, hem après què són els plugins, com instal·lar-los, utilitzar-los i gestionar-los. També hem vist exemples pràctics d'ús de plugins com la càmera, la vibració i la geolocalització. Amb aquests coneixements, estàs preparat per explorar i utilitzar una àmplia varietat de plugins en les teves aplicacions Cordova.

En el següent tema, explorarem com utilitzar l'API del dispositiu per accedir a informació específica del maquinari i el sistema operatiu del dispositiu.