Ver el código de «SDKs:Miner:iOS:index»

#CÓMO AGREGAR EL FRAMEWORK MINER EN IOS

== INTRODUCCIÓN. ==


El <i>framework</i> <b>Miner</b> permite monetizar la aplicación a través del minado de operaciones de <b><i>blockchain</i></b>. 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 <i>framework</i>.

* El tiempo que está el <i>framework</i> minando.


== VERSIONES DE IOS SOPORTADAS. ==


Este <i>framework</i> admite la versión <b>10.0</b> de <b>iOS</b> y superiores.

== INSTALACION DEL FRAMEWORK. ==


Existen dos maneras de instalar el <i>framework</i> <b>Miner</b>:
* A través de <b>CocoaPods</b>. Opción recomendada.

* Descargándolo directamente.


=== Instalación con CocoaPods. ===


En caso de que su proyecto no incluya el archivo <b><i>Podfile</i></b>, incorpórelo. Si nunca ha trabajado con <b>CocoaPods</b> consulte la [https://guides.cocoapods.org/using/using-cocoapods.html documentación ofrecida en su web oficial], en la que se explica paso a paso cómo instalar <b>CocoaPods</b> y cómo crear, actualizar y trabajar con los archivos <b><i>Podfile</i></b>.

Añada al archivo <b><i>Podfile</i></b> 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 <b><i>workspace</i></b> de su proyecto de la siguiente manera:

https://panel.mobeleader.com/ficheros_subidos/librerias/imagenes/NickCenter/Proyecto_nc_ios_8.png

Abra el proyecto desde el <b><i>workspace</i></b> para poder usar el <i>framework</i> correctamente.

=== Instalación manual del <b><i>framework</i></b>. ===


Descargue el <i>framework</i> <b>Miner</b>:

* Desde la [página principal de las librerías](http://panel.mobeleader.com/index.php?sec=82):


https://panel.mobeleader.com/ficheros_subidos/librerias/imagenes/miner/miner_download.png

* Desde la [página de información del <i>framework</i> <b>Miner 1.00 </b> de <b>iOS</b>](http://panel.mobeleader.com/index.php?sec=85&id=53&tipo=7):


https://panel.mobeleader.com/ficheros_subidos/librerias/imagenes/sps/desc_framework.png

* Directamente desde [aquí](https://repos.mobeleader.com/MobeleaderMiner/1.0.36/MobeleaderMiner-1.0.36.zip).


Una vez descargado el <b><i>framework</i></b> instálelo en su proyecto.

== LANZAMIENTO DEL FRAMEWORK. ==


Seleccione el  <b><i>controller</i></b> desde el cual quiera ejecutar el minado e importe la cabecera:

```cpp
#import <MobeleaderMiner/Miner.h>
```

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

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

Los campos <b>setAppHash:@“appHash”</b> y <b>setRootViewController</b> son obligatorios.

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

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

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

== DELEGATES. ==


El <i>framework</i> <b>Miner</b> está dotado de varios <b><i>delegates</i></b> opcionales:

* <b>onLibStart</b>: notifica el lanzamiento del <i>framework</i>.

* <b>onStartMining</b>: notifica cuando el <i>framework</i> comienza el proceso de minado.

* <b>onStop</b>: notifica al detener el proceso de minado.

* <b>onError</b>: notifica cuando el <i>framework</i> haya tenido algún error. Devuelve un <b><i>string</i></b> con la descripción del error producido.


Para acceder a los <b><i>delegates</i></b>, la llamada al <i>framework</i> <b>SpsLib</b> deberá realizarse de la siguiente forma (se pueden implementar tantos <b><i>delegates</i></b> 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 <b><i>blockchain</i></b> (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.