Al pasar de la versión 3 a la 4 de Xcode una de las cosas más molestas que nos hemos encontrado fue la forma de mostrar la documentación. Antes, al abrir la documentación de una clase, en el lado izquierdo de la ventana podíamos ver una especie de índice que nos permitía visualizar directamente la lista de métodos de clase y de instancia que tenía esa clase concreta y podíamos saltar directamente a ver la info de un método determinado, etc.

Con la salida del Xcode 4 esa tabla de contenidos desapareció (con el tiempo que nos ahorraba).

Resumiendo, para volver a mostrar esa tabla de contenidos en la documentación hay que ejecutar el siguiente comando en la terminal (recomiendo hacer un backup de los docsets por si algo sale mal):

sudo egrep -lRZ "Prototype.Browser.Xcode4OrNewer=Prototype.Browser.XcodeVersion<1000;" /Library/Developer/Documentation/DocSets | xargs -0 -L % sudo sed -i '' -e 's/Prototype\.Browser\.Xcode4OrNewer\=Prototype\.Browser\.XcodeVersion\<1000\;/Prototype\.Browser\.Xcode4OrNewer\=false\;/g'

Esta información se ha obtenido de este hilo de stackoverflow.

En muchas ocasiones necesitamos incrustrar vídeos youtube en nuestras apps.

Aquí les presentamos una clase que hemos programado que nos hace de reproductor de youtube.

Básicamente es una UIWebView con el html necesario para mostrar el vídeo.

Y se usuaría de la siguiente manera:

ZBYouTubeView *vid = [[ZBYouTubeView alloc] initWithFrame:self.bounds andUrl:@”http://www.youtube.com/watch?v=nmwIgF2gekY&feature=feedf”];

Es otra vista más que podemos añadir en cualquier sitio.

El tamaño del vídeo se adapta automáticamente si cambiamos el tamaño de la vista.

También se encarga de mostrar un UIActivityIndicatorView mientras carga el vídeo.

Cómo nos recuerdan en el primer comentario sólo funciona en el dispositivo por lo que si no véis nada en el simulador no os preocupéis.

Espero que les sea útil.

Descargar código

Hace unos minutos descubri un error en una de mis aplicaciones y pensé que estaría bien comentarlo con el resto de la gente para que no cometan el mismo error.

Cuando intentamos enviar emails desde nuestras aplicaciones usando el MFMailComposeViewController podemos tener un problema si los usuarios no tienen configurada ninguna cuenta.

mail = [[MFMailComposeViewController alloc] init];
[mail setMessageBody:[NSString stringWithFormat:@"Texto del cuerpo"]  isHTML:YES];
mail.mailComposeDelegate = self;
[self presentModalViewController:mail animated:YES];
[mail release];

El problema con el código de arriba consiste en que si el usuario no tienen ninguna cuenta configurada por lo que el init del MFMailComposeViewController devolverá nil y al intentar mostrar la vista de mail ([self presentModalViewController:mail animated:YES]) la aplicación se cerrará.

Para evitar eso tenemos que comprobar que el mail no es nil antes de hacer nada. El código buenos sería este:

mail = [[MFMailComposeViewController alloc] init];
[mail setMessageBody:[NSString stringWithFormat:@"Texto del cuerpo"]  isHTML:YES];
mail.mailComposeDelegate = self;
if (mail !=nil)
    [self presentModalViewController:mail animated:YES];
else
   //Informar al usuario o lanzar la aplicación mail.
[mail release];

Según la aplicación que estamos desarrollando, puede ser interesante o incluso necesario evitar que el iPhone se autobloquee mientras nuestra aplicación esta en marcha. Por suerte tenemos una manera muy sencilla de conseguirlo y con sólo una instrucción.

[UIApplication sharedApplication].idleTimerDisabled = YES;

Eso es todo lo que necesitamos para que el iPhone permanezca todo el tiempo encendido, un buen lugar para ponerlo es en el método applicationDidFinishLaunch: en nuestro UIApplication delegate.

Tened cuidado porque si el usuario sale corriendo y deja su iPhone solo, durante mucho tiempo, al dejar la pantalla encendida todo el rato, lo dejaremos sin batería.

Hoy vamos a ver qué es “weak linking” (linkado débil?), para qué sirve y como usarlo en nuestros proyecto.

Una de las decisiones a tomar cuando empezamos un nuevo proyecto es la de decidir cuál es el dispositivo y/o sistema básico que soportorá nuestra app (iPhone 2G con IOS 2.0? , sólo iPhone 4.0 con iOS4, ipad? o todos?).

Esta claro que cuanto más dispositivos y versiones de SO soportemos a más gente podremos llegar pero para eso tendremos que hacer esfuerzos extra.

El problema consiste en que de una versión a otra se introducen nuevos frameworks, se modifican funciones, se añaden nuevas funcionalidades, etc. A priori si usamos esos nuevos frameworks entonces nuestras apps no funcionarán en las versiones anteriores. Aquí es donde entra weak linking (entre otros) para ayudarnos.

Entonces, vamos a ver un caso práctico donde el “weak linking” nos puede ser útil.

Por ejemplo en iOS 3.0 se introdujo el framework llamado MessageUI que nos permite enviar emails ( y ahora con iOS 4 también SMSes) desde nuestra aplicación. Se encarga de mostrar la interfa de edición de email y permite enviarlo directamente desde nuestra app.

Entonces, que pasa si quieres usar ese nueve framework pero al mismo tiempo queremos que nuestra app siga siendo compatible con las versiones anteriores de iOS?

Muy simple, al incluir este nueva framework en nuestro proyecto lo tenemos que marcar como “weak”.

Para marcar el framework como weak tenemos que hacer click derecho en el Target  para el que queremos hacer el “weak linking” y en el menú desplegable seleccionar “Get Info”:

Luego en la ventana que se abre nos vamos a la pestaña General y abajo de todo veremos el listado de frameworks que se usan para el target seleccionado. En ese listado marcamos el MessageUI.framework como “weak”.

Y está con esto hemos hecho el “weak linking” y ahora el programa se ejecutará tanto en iOS 2,0 (que no tiene MessageUI) como en iOS 3.

He dicho que se ejecutará ahora porque hemos añadido el framework pero por ahora no hems usando ninguna de las clases o funcionces de ese framework.

Si en alguna parte de nuestra app queremos mostrar la vista de edición de email (proporcionado por MessageUI) pondríamos un código parecido a este:

MFMailComposeViewController *mail = [[MFMailComposeViewController alloc] init];
[mail setMessageBody:@"mi mensaje"  isHTML:NO];
mail.mailComposeDelegate = self;
[self presentModalViewController:mail animated:YES];
[mail release];

Después de poner este código la aplicación funcionará bien en iOS3 pero petará en iOS2. Entonces, a parte del weak linking tenemos que de alguna manera preguntar si durante la ejecución están disponibles las clases (también funcionar, métodos, etc) que necesitamos (en este caso tenemos que asegurarnos que el MFMailComposeViewController está disponible).

En el caso de ejemplo tendríamos que hacer lo siguiente:

if (NSClassFromString(@"MFMailComposeViewController") != nil) {
 
	MFMailComposeViewController *mail = [[MFMailComposeViewController alloc] init];
	[mail setMessageBody:@"mi mensaje"  isHTML:NO];
	mail.mailComposeDelegate = self;
	[self presentModalViewController:mail animated:YES];
	[mail release];
 
}else{
		//Hacer algo pensado para las versiones anteriores
}

Con esto si que conseguiremos que la app se ejecute sin problemas tanto en iOS3 como en iOS2.

Pero en este caso todavía podemos rizar más el rizo. La presencia de un framework en el sistema no significa que este puede usarlo. Por ejemplo en el iOS 4 tenemos el MFMessageComposeViewController que sirve para enviar SMS. Si tenemos un iPod touch con iOS4 instalado tendremos ese framework disponible pero eso no significa que vayamos a poder enviar SMSes desde el iPod.

Volviendo al ejemplo anterior, la versión con aun más seguridad/compatibilidad sería este:

if (NSClassFromString(@"MFMailComposeViewController") != nil) {
	if ([MFMailComposeViewController canSendMail]){
		MFMailComposeViewController *mail = [[MFMailComposeViewController alloc] init];
		[mail setMessageBody:@"mi mensaje"  isHTML:NO];
		mail.mailComposeDelegate = self;
		[self presentModalViewController:mail animated:YES];
		[mail release];
 
	}else{
		//hacer algo pensado para un dispositivo de donde no podemos enviar emails
	}
 
}else{
	//Hacer algo pensado para las versiones anteriores
}

Esto que acabamos de ver se llama programación condicional que básicamente nos permite asegurarnos que determinados recursos existen en el sistema antes de usarlos.
Apple recomienda hacer estas comprobaciones a nivel más abajo (funciones y clases) y no a nivel de dispositivo. Es decir, no se recomienda comprobar que estamos ejecutando en un iPhone y dar por seguro que ciertas funciones existen.

En los ejemplos hemos visto cómo comprobar si una clase existe usando la función NSClassFromString() que nos devuelve nul si la clase no existe.
Para comprobar si un método existe o no podemos usar los métodos instancesRespondToSelector y respondsToSelector.
En el caso de funciones podemos comprobar su existencia comparando el nombre de la función con NULL:

if (miFuncion==NULL)
     NSLog(@"La función miFunción no existe");

Para más detalles sobre este tema podéis consultar la SDK Compatibility Guide (está en inglés y tenéis que estar registrados apra verlo) de Apple.

Y como siempre, si tenéis dudas, consultas, sugerencias, correcciones no dudéis un usar los comentarios o nuestro foro.

Hace algún tiempo os comenté como detectar cambios en propiedades mediante el KVO (Key-Value Observing) hoy veremos como hacer lo mismo con notificaciones.

La idea del ejemplo es la siguiente: Tenemos un objeto A de una clase X, del que queremos ser avisados cuando una propiedad sea modificada, para ello avisaremos a otro objeto B, para que éste último realize alguna acción. Para ello usaremos notificaciones, el objeto A enviará una notificación cuando cambie su propiedad y el objeto B estará pendiente de dichas notificaciones.

Veamos como hacer esto desde el código, primero nos creamos una función que será la encargada de enviar las notificaciones. Usamos el centro de notificaciones por defecto de nuestra aplicación y el método postNotificationName:object: para enviar la notificación. Los parámetros son un string para el nombre de la notificación y el objeto que envía la notificación.

#pragma mark -
#pragma mark Notification methods
 
- (void)sendNumberPadPressedNotification {
     [[NSNotificationCenter defaultCenter] postNotificationName:@"number pad pressed" 
                                                         object:self];
}

Después sólo tenemos que llamar a esta función cada vez que queramos notificar del evento o cambio producido, por ejemplo si pulsamos un botón.

#pragma mark -
#pragma mark Notification methods
- (IBAction)ceroButtonPushed:(id)sender {
     [input setString:[numberFormater stringFromNumber:[NSNumber numberWithFloat:0.00]]];
     coma = NO;
     decimal = 1;
     [self sendNumberPadPressedNotification];
}

En la última línea llamamos a nuestro método y la notificación es enviada, en este ejemplo se usa para avisar de que input fue cambiado.

Esto es todo lo que necesita nuestro objeto A (el que avisa del cambio o evento). Veamos ahora el código para el objeto B (el que quiere ser avisado).

Lo primero que tenemos que hacer es registrar el objeto B en el centro de notificaciones para poder recibirlas, obviamente nos tenemos que registrar en el mismo centro de notificaciones que el objeto A, en este caso el centro por defecto.

Usamos para ello el método addObserver:selector:name:object: los parámetros son: el objeto a registrar, un selector del método que queremos ejecutar al recibir la notificación, el nombre de la notificación para la que queremos ser avisados y el objeto sobre el que queremos ser avisado, éste último puede ser nil o el objeto en concreto, para poder diferenciar quien manda la notificación en caso de tener más de un objeto enviando la misma notificación.

 // Implement viewDidLoad to do additional setup after loading the view, typically from a nib.
 - (void)viewDidLoad {
     [super viewDidLoad];
     numberPadController = [[GenericNumberPad alloc] initWithNibName:@"GenericNumberPad"
     	  						      bundle:[NSBundle mainBundle]
							       frame:CGRectMake(20, 190, 280, 216)];
     [[NSNotificationCenter defaultCenter] addObserver:self 
                                              selector:@selector(numberPadPressed)
						  name:@"number pad pressed" object:nil];
     [[self view] addSubview:[numberPadController view]];
 }

Cómo veis en el código, el nombre de la notificación es el mismo que se usó en el objeto A. Ya sólo queda que realiceis vuestras acciones en el método que indicasteis a la hora de registrar el objeto B.

#pragma mark -
#pragma mark Notification methods
 
- (void)numberPadPressed {
     [importLabel setText:[numberPadController input]];
}

En este ejemplo se ha usado para actualizar una etiqueta con el valor de la variable input, cada vez que ésta era cambiado.

En este post veremos como podemos obtener archivos que nuestra aplicación cree durante su ejecución, ésto nos puede ser útil cuando queremos comprobar que se han creado correctamente o cuando queremos obtener la base de datos que estemos creando desde la aplicación.

Para ello usaremos Xcode desde la ventana “organizer”, que podéis abrir desde el menú ventana. Desde el organizer y con vuestro iPhone conectado tendremos acceso a las aplicaciones instaladas en éste, sólo tendremos acceso a nuestras aplicaciones. Localizamos nuestra aplicación y pulsamos sobres el triángulo de la izquierda para ver su contenido.

Ahora deveríamos estar viendo un icono de una caja, el típico icono de package de las instalaciones.

Sólo nos queda arrastrar este icono al escritorio y obtendremos una carpeta con el contenido de las carpetas Documents, Library y tmp de nuestra aplicación y los archivos que contienen.

Con esto y el post anterior que nos mostraba como copiar un archivo a la carpeta documents, ya podemos acceder a cualquier archivo que creemos en nuestra aplicación.

Otra cosa a tener en cuenta es que si añadimos o modificamos archivos de esta carpeta, y arrastramos la carpeta de vuelta a nuestra aplicación en la ventana organizer, podremos meter cualquier archivo que queramos en las carpetas de la aplicación.

Con este post mostraré como podemos copiar un archivo, que previamente hemos añadido a nuestro proyecto, a la carpeta documentos de nuestra aplicación. La idea es la de poder inicializar de una manera rápida y cómoda la base de datos, algún archivo de configuración que tengamos o cosas por el estilo que tenemos que guardar en la carpeta documentos de la aplicación porque durante ejecución sufrirán cambios realizados por el usuario, evitando así tener que crearlos desde el código de la aplicación.

Primero, lo que tenemos que hacer es añadir ese archivo al proyecto para tener acceso a él desde el código cuando se ejecuta la aplicación. Añadid el archivo a la carpeta “Resources” del proyecto.

Una vez tenemos el archivo en el proyecto, podemos añadir el código para copiar el archivo a la carpeta documentos, añadid el siguiente código en vuestro AppDelegate, podéis crearos una función nueva para inicializar los archivos que necesiteis, o añadirlo directamente al init del AppDelegate.

// Copy init.sqlite from resources to the Documents folder in bundle
NSString *storePath = [[self applicationDocumentsDirectory] stringByAppendingPathComponent: @"data.sqlite"];
if(![[NSFileManager defaultManager] fileExistsAtPath:storePath])
{
	NSString *filePath = [[NSBundle mainBundle] pathForResource:@"init" ofType:@"sqlite"];
	NSData *myData = [NSData dataWithContentsOfFile:filePath];
	if (![myData writeToFile:storePath atomically:YES]) {
		NSLog(@"ERROR writting the starting database");
	}
}

En el ejemplo anterior usamos un archivo, init.sqlite, como base de datos inicial para nuestra aplicación y guardamos el mismo archivo bajo el nombre de data.sqlite en el directorio documentos de nuestra aplicación. Daos cuenta también de que usamos un if para comprobar si el archivo existe o no, de forma que sólo se ejecutará la primera vez que ejecutemos la aplicación, ésto es así, para que cuando nuestro usuario vaya añadiendo datos no se los borremos y carguemos siempre la base de datos inicial. Si durante las pruebas queréis volver a obtener el archivo original, eliminad la aplicación del iPhone o del iPhone Simulator.

El método applicationDocumentsDirectory es la siguiente función que nos devuelve la ruta a la carpeta.

/**
 Returns the path to the application's Documents directory.
 */
- (NSString *)applicationDocumentsDirectory {
	return [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
}

En este artículo vamos explicar los métodos de inicialización de objetos en Objective-C. Veremos cómo sobrecargarlos correctamente y como crear nuestros propios de la forma más correcta.

Antes que nada vamos a ver cómo solemos sobrecargar el método init en nuestras clases que heredan del NSObject y entender el porque lo hacemos así.

-(id)init{
 
    if (self = [super init]){
 
      // Aquí incializamos nuestros variables
 
    }
    return self;
}

Con el [super init] inicializamos las variables de la clase padre. Esta inicialización está en un if para no inicializar nuestro código y devolver un objeto corrupto con variables a medio inicializar ya que si el [super init] devuelve un nil ya no entraremos dentro del if. De esta forma o retornamos un objeto completo o nil. Dentro del if al inicializar nuestras variables si se produce algún error tenemos que retornar nil.

Regla: antes de incializar nuestras variables SIEMPRE tenemos que incializar la clase padre. Siempre vamos de arriba hacía abajo en la jerarquía.

Vamos a suponer que tenemos una clase Alumno definido de la siguiente manera:

@interface Alumno : NSObject {
	NSString *nombre;
	NSString *apellido;
}
 
@property (nonatomic, retain)NSString *nombre;
@property (nonatomic, retain)NSString *apellido;
 
@end

Y su implementación es la siguiente:

@implementation Alumno
@synthesize nombre, apellido;
 
@end

Entonces, usaríamos esta clase de la siguiente manera:

Alumno *a = [[Alumno alloc] init];
a.nombre = @"Pepe";
a.apellido = @"Garcia";
NSLog(@"Nombre de alumno: %@ y  apellido: %@", a.nombre, a.apellido);

Fijaros que para inicializar llamamos el init que no está definido en nuestra clase pero viene heredada de la clase padre (NSObject) por lo que al hacer esta llamada las variables nombre y apellido no se inicializan pero si se inicializan las variables de la clase padre.
Es natural querer que nuestra clase Alumno tenga un inicializador tipo “initConNombre:(NSString *)n yApellido:(NSString *)a” que nos permita poner directamente el nombre y el apellido del alumno.

También puede que queramos un inicializador que sólo acepte el nombre del alumno tipo “initConNombre:(NSString *)n”.

Entonces, para organizar bien nuestros inicializadores, no duplicar código y asegurarnos que todas las variables se inicializan correctamente independientemente del incializador usado se usan los inicializadores designados (designed initializators).

Inicializadores designados

Cada clase ha de tener un inicializador designado y será este el único inicializador que llamara a [super init] y se encargará de inicializar todas las variables usados por nuestra clase. El resto de los inicializadores tendrán que llamar a este inicializador.

Volviendo a nuestra clase alumno. ¿Cuál es su inicializador designado?
Lo tenemos que decidir nosotros. Casi siempre es el inicializador con más parámetros. En nuestro caso el inicializador por defecto sera este: -(id)initConNombre:(NSString *)n yApellido:(NSString *)a
A continuación vamos a ver como implementaríamos los inicializadores de nuestra clase.

#import "Alumno.h"
 
#define NOMRE_POR_DEFECTO @""
#define APELLIDO_POR_DEFECTO @""
 
@implementation Alumno
@synthesize nombre, apellido;
 
-(id)initConNombre:(NSString *)n yApellido:(NSString *)a
{
    if (self = [super init])
    {
 
    }
    return self;
}
 
-(id)initConNombre:(NSString *)n{
	return [self initConNombre:n yApellido:APELLIDO_POR_DEFECTO];
}
 
-(id)init{
	return [self initConNombre:NOMRE_POR_DEFECTO];
}
 
@end

Fijaros como desde el init llamamos al siguiente inicializador pasándole el valor por defecto, a su vez el siguiente inicializador llama al inicializador por defecto quien es el único en hacer el [super init] e incializar las variables del Alumno. Esto en la jerga de Objective-C se llama “initialization chain”. Usar cadenas de inicialización reduce la probabilidad de que cometamos errores y facilita el mantenimiento del código.

También es muy importante darse cuenta del porque definimos nuestro propio init sobreescribiendo el init (que es el init designado) del NSObject. Si no lo hubieramos hecho al hacer [[Alumno alloc] init] inicializaríamos las variables del NSObject pero no las de Alumno. Al sobreescribirlo conseguimos inicializar tanto nuestras variables como las de la clase padre. Siempre, al heredar de una clase tenemos que sobreescribir el inicializador designado de esa clase.

Resumen de las tres reglas (recomendaciones)

Regla 1: antes de incializar nuestras variables SIEMPRE tenemos que incializar la clase padre. Siempre vamos de arriba hacía abajo en la jerarquía.

Regla 2: los inicializadores de nuestras clases siempre tienen que acabar llamando al inicializador designado de nuestra clase.

Regla 3: siempre tenemos que sobreescribir el inicializador designado de la clase de la que heredamos.

Podéis descargar el código con el ejemplo que hemos visto en este artículo.
Inicializadores

Cuando trabajamos con tablas (UITableView), podemos crear celdas personalizadas a través de Interface Builder o crearlas directamente desde el código, el problem aparece cuando cambiamos el color de fondo por otro que no sea blanco y sólo creamos la celda cuando vamos a mostrar datos, pero no hacemos nada para las celdas vacías.

Nos encontramos con algo como esto

Esto nos pasa porque sólo creamos la celda con fondo cuando tenemos datos para rellenar, tenemos dos opciones para solucionarlo:

• Programar nuestro código de forma que cuando rellenamos la tabla se consideren los casos en que no hay datos, es decir cargar una celda pero sin las etiquetas o imágenes.
• Poner a todas las celdas el mismo color de fondo antes de mirar nada.

Con esta segunda opción, es la más rápida, podemos darle el mismo color a todas las celdas, la única manera de hacerlo sin crearnos una celda personalizada, sin nada más que el fondo para celdas vacías desde Interface Builder, es hacerlo dentro del código:

// Customize the appearance of table view cells.
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
 
    static NSString *CellIdentifier = @"Cell";
 
    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:CellIdentifier];
    if (cell == nil) {
        cell = [[[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:CellIdentifier] autorelease];
    }
 
    // Configure the cell.
    [[cell contentView] setBackgroundColor:[UIColor colorWithRed:0 green:128/255.f blue:0 alpha:1]];    
    return cell;
}

La linea que nos interesa es la que llama al método setBackgroundColor:, con esta linea es la que le damos el color que queremos. Daros cuanta de que usamos [cell contentView], tenemos que cambiar el color de la contentView, esta es la clave de que no se pueda hacer desde Interface Builder directamente cuando añadimos una tabla, desde la tabla no podemos acceder al contenido de la celda sin añadir explicitamente las celdas.

Con esa linea obtendremos algo cómo esto