SDKs:Miner:iOS:index

1. CÓMO AGREGAR EL FRAMEWORK MINER EN IOS

INTRODUCCIÓN.

El framework Miner permite monetizar la aplicación a través del minado de operaciones de blockchain. Las ganancias generadas dependerán del número de operaciones minadas por la app, lo cual dependerá, a su vez, de dos factores:

• La capacidad del procesador del terminal en el que se está ejecutando el framework.

• El tiempo que está el framework minando.

VERSIONES DE IOS SOPORTADAS.

Este framework admite la versión 10.0 de iOS y superiores.

INSTALACION DEL FRAMEWORK.

Existen dos maneras de instalar el framework Miner:

• A través de CocoaPods. Opción recomendada.

• Descargándolo directamente.

Instalación con CocoaPods.

En caso de que su proyecto no incluya el archivo Podfile, incorpórelo. Si nunca ha trabajado con CocoaPods consulte la documentación ofrecida en su web oficial, en la que se explica paso a paso cómo instalar CocoaPods y cómo crear, actualizar y trabajar con los archivos Podfile.

Añada al archivo Podfile de su proyecto las siguientes dependencias:

   pod 'MobeleaderMiner'

A continuación, en el directorio de su proyecto ejecute la siguiente línea de comandos:

   $ pod install --repo-update

Se creará el workspace de su proyecto de la siguiente manera:

Abra el proyecto desde el workspace para poder usar el framework correctamente.

Instalación manual del framework.

Descargue el framework Miner:

• Desde la página principal de las librerías:

• Desde la página de información del framework Miner 1.00 de iOS:

• Directamente desde aquí.

Una vez descargado el framework instálelo en su proyecto.

LANZAMIENTO DEL FRAMEWORK.

Seleccione el controller desde el cual quiera ejecutar el minado e importe la cabecera:

```cpp

1. import <MobeleaderMiner/Miner.h>

```

Declare la clase Miner como atributo global en el implementation: ```cpp Miner *miner; ```

En el viewDidLoad del controller inicialice la clase: ```cpp miner = [[Miner alloc] init]; miner.delegate = self; [miner setAppHash:@"app_hash"]; [miner setRootViewController:self]; ```

Los campos setAppHash:@“appHash” y setRootViewController son obligatorios.

En el campo appHash ha de introducir el código hash de su aplicación, generado al registrar su aplicación en el Panel de Mobeleader. Lo puede obtener en la sección [Mis Aplicaciones](http://panel.mobeleader.com/index.php?sec=6), pulsando el icono de la columna "Hash" de su aplicación.

Una vez inicializada la librería y definidos los parámetros utilice el método start para comenzar el proceso de minado: ```cpp [miner start]; ```

Utilice el método stop para detener el proceso de minado cuando lo desee: ```cpp [miner stop]; ```

DELEGATES.

El framework Miner está dotado de varios delegates opcionales:

• onLibStart: notifica el lanzamiento del framework.

• onStartMining: notifica cuando el framework comienza el proceso de minado.

• onStop: notifica al detener el proceso de minado.

• onError: notifica cuando el framework haya tenido algún error. Devuelve un string con la descripción del error producido.

Para acceder a los delegates, la llamada al framework SpsLib deberá realizarse de la siguiente forma (se pueden implementar tantos delegates como se quiera, no es necesario implementarlos todos):

   - (void)onLibStart
   {
       // Complete delegate
   }
   
   - (void)onStartMining
   {
       // Complete delegate
   }
   
   - (void)onStopMinig
   {
       // Complete delegate
   }
   
   - (void)onError:(NSString *)error
   {
       // Complete delegate
   }

CONSIDERACIONES ACERCA DEL MINADO.

• El proceso de minado se traduce en un consumo significativo de la batería, por lo que recomendamos no abusar de su uso.

- El minado de operaciones blockchain (coloquialmente conocido como minado de criptomonedas) es un ámbito desconocido para la mayor parte de los usuarios. Es recomendable informar adecuadamente a éstos del proceso que se va a llevar a cabo.