Breve post per segnalarvi che Apple ha appena rilasciato la nuova versione dell’iTunes Connect Developer Guide, che si aggiorna così alla versione 5.5

Per chi non lo sapesse, questa è la guida ufficiale di Apple su come devono essere realizzare le applicazioni e cosa bisogna fare per inviarle per la vendita in AppStore. Ogni passo ed ogni informazioni richiesta nell’iTunes Connect è spiegata in questa guida, assolutamente da leggere per tutti gli sviluppatori.

I cambiamenti di questa versione sono i seguenti (in inglese):

• iPad screenshots, icon and delivery requirements as well as details on a new status called Missing Screenshot;
• Details on how to enable your app for Game Center and set up your Leaderboard to test using iPhone SDK 4 beta;
• Interval pricing details to help you learn how to schedule price tier changes in advance for your apps and in app purchases;
• Information on the Over the Air download limit;
• Recommended app name character count for optimal display on desktop and device App Stores.

Potete scaricare l’iTunes Connect Develiper Guide a questo indirizzo.

In questo nuovo appuntamento con i nostri “Tips&Tricks” sulla programmazione per iPhone, vedremo come copiare del testo nella clipboard. Faremo in modo, infatti, che premendo un bottone venga copiato del testo, che sarà disponibile poi nella clipboard del nostro iPhone!

Nel file “.h” vostra classe in cui volete implementare questa funzionalità dovrete dichiarare un componente UIPasteboard. Eccovi un esempio qui di seguito:

@interface provaClipboardViewController : UIViewController {
	UIPasteboard *pasteboard;
}
 
-(IBAction)copiaTesto;
 
@end

Alla riga 2 abbiamo definito una UIPasteboard, che ci permetterà di interagire con la clipboard dell’iPhone. Abbiamo, inoltre, definito un’azione “copiaTesto”, che abbiamo poi collegato ad un tasto definito in Interface Builder.

Nel file “.m” della classe dovremo poi definire il metodo “copiaTesto”. Le istruzioni che ci interessano sono alle righe 2 e 3:

-(IBAction)copiaTesto{
	pasteboard = [UIPasteboard generalPasteboard];
	pasteboard.string = @"XCode Tips&Tricks by BubiDevs";
 
	UIAlertView *alert=[[UIAlertView alloc] initWithTitle:@"BubiDevs!" message:@"Testo copiato" delegate:self cancelButtonTitle:@"OK" otherButtonTitles:nil];
	[alert show];
	[alert release];
}

Come vedete bastano due semplicissime istruzioni per copiare del testo nella clipboard.

Eccovi questo utilissimo tips in funzione:

Spero vi sia piaciuto, se avete dei tips&tricks da suggerirci contattateci tramite l’apposito form!

(fonte)

Alcuni utenti di BubiDevs mi hanno chiesto come fare per leggere un documento pdf all’interno delle nostre applicazioni.

Il procedimento è davvero molto semplice, basta partire da una comune UIWebView (potete utilizzare il nostro tutorial #8).

Invece di caricare un indirizzo HTML utilizzate le seguenti istruzioni:

1
2
3
4
5
6
7
8

	// carica il file pdf da locale
	NSString *indirizzo = [[NSBundle mainBundle] pathForResource:@"prev" ofType:@"pdf"];
	NSURL *url = [NSURL fileURLWithPath:indirizzo];
	NSURLRequest *requestObj = [NSURLRequest requestWithURL:url];
	// visualizza la pagina nella UIWebView
	[webView loadRequest:requestObj];
	// scala il contenuto della pagina a seconda delle dimensioni della UIWebView
	webView.scalesPageToFit = YES;

La prima istruzione ci permette di caricare un file pdf chiamato “prev”, che ovviamente deve essere inserito all’interno del nostro progetto. Le istruzioni 3, 4 e 6 non cambiano, sono uguali a quelle che già conoscete.

L’unica istruzione che merita un po’ più di attenzione è l’ultima (riga 7). Essa ci permette di scalare il contenuto all’interno della nostraUIWebView, in modo che si adatti alla sua dimensione. Ecco come si presenta il nostro lettore di pdf:

Ed ecco come invece sarebbe senza l’utilizzo dell’istruzione “scalePageToFit”, sicuramente molto meno “user-friendly”:

Spero che questo tips vi sia stato utile, se volete segnalarmi dei vostri Tips&Tricks ne sarei molto felice, li inserirei sicuramente in questa rubrica!

Oggi vi propongo un nuovo tips di XCode, che potrebbe non avere tantissima utilità (in alcuni casi), ma potrebbe aggiungere un “tocco di classe” alle vostre applicazioni.

Vedremo, infatti, come capire quando una UIWebView inizia il caricamento  della pagina web (o meglio, quandi inizia una URLRequest) e quando la finisce.

Per controllare questi due aspetti non dovrete far altro che implementare nella vostra classe il protocollo “UIWebViewDelegate”:

@interface SingoloFeedSafariViewController : UIViewController <UIWebViewDelegate> {

e inserire, poi, questi due metodi nel file .m di implementazione della classe:

- (void)webViewDidStartLoad:(UIWebView *)view{
	[spinner startAnimating];
}
 
- (void)webViewDidFinishLoad:(UIWebView *)view{
	[spinner stopAnimating];
}

Io ho semplicemente avviato e fermato una “UIActivityIndicatorView”, che mostrerà così all’utente il progresso del caricamento. Ecco due screen che vi mostrano questo semplice codice in funzione, nella prima immagine vedete la rotella attiva, mentre al file caricamento è ferma e non viene, ovviamente, visualizzata.

Spero possa tornarvi utile, al prossimo appuntamento con “XCode Tips&Tricks”

Nell’appuntamento di oggi vedremo come rilevare quando la nostra applicazione va in “debito di memoria” (per rubare un’espressione agli atleti), ovvero quando la memoria RAM disponibile diventa poca e potrebbe compromettere il corretto funzionamento della nostra applicazione.

Per rilevare tale mancanza ci basterà implementare il seguente metodo nel file “[nome-progetto]AppDelegate.m” del nostro progetto:

- (void)applicationDidReceiveMemoryWarning:(UIApplication *)application{
	UIAlertView *avvisomem = [[UIAlertView alloc] initWithTitle:@"Attenzione!" message:@"Poca memoria disponibile!" delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil];
 
	[avvisomem show];
	[avvisomem release];
}

Come potete vedere abbiamo semplicemente creato una UIAlertView che avviserà l’utente della scarsa memoria disponibile. Dopo aver avviato l’applicazione nel Simulatore, ci basterà andare nel menù “Hardware -> Simula avviso memoria”

ed ecco che comparirà il messaggio di avviso:

Fateci sapere cosa ne pensate di questo tips&tricks!

Rieccoci per un nuovo tips&tricks dedicato alla programmazione per iPhone SDK. Oggi vedremo come cambiare l’user agent delle UIWebView.

Lo UserAgent è, nella sua accezione più usata ma forse meno precisa, è un parametro che ci fornisce delle indicazioni su chi (o che cosa) si è connesso ad un server web. Per farvi un esempio, ogni browser ha il suo UserAgent, così come ogni applicazione che accede ad un server. Lo user agent permette di ricavare informazioni quali il browser utilizzato, il sistema operativo ed altro.

Questa informazione viene anche utilizzata quando utilizzate Safari Mobile per accedere ai vostri siti preferiti: sfruttando tale informazione, infatti, sarà possibile caricare una versione ottimizzata del sito web (come accada anche se aprite BubiDevs dal vostro iPhone).

Oggi vedremo come variare lo UserAgent dei componenti UIWebView, in modo che possiate avere un metodo per caricare pagine web personalizzate, magari con componenti visibili solo all’interno della vostra applicazione.

Per prima cosa, inserite il delegato “UIWebViewDelegate” nella vostra classe. Eccovi un esempio:

1

@interface ViewSafariController : UIViewController  <UIWebViewDelegate>{

Fatto ciò, dovrete implementare tale metodo:

1
2
3
4
5
6
7
8
9

/* Modifica l'user agent del browser, in modo da caricare la pagina corretta */
- (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)req navigationType:(UIWebViewNavigationType)navigationType {
    NSMutableURLRequest *request = (NSMutableURLRequest *)req;
 
    if ([request respondsToSelector:@selector(setValue:forHTTPHeaderField:)]) {
        [request setValue:[NSString stringWithFormat:@"%@ AppNuova", [request valueForHTTPHeaderField:@"User-Agent"]] forHTTPHeaderField:@"User_Agent"];
    }
    return YES;
}

È obbligatorio inserire il codice che vi ho appena riportato in questo metodo, altrimenti il vostro UserAgent non varierà e rimarrà sempre lo stesso (ve lo dico per esperienza personale xD).

La riga importante è la 6, in cui notate come abbiamo inserito “AppNuova” come UserAgent della nostra applicazione. Semplice vero?

Eccovi ora una prova di quello che abbiamo appena creato. Per un’applicazione che sto realizzando dovevo eliminare l’header del tema WPTouch (quello che utilizzo anche io nella versione mobile del blog), quindi ho inserito del codice php che mi controlla l’user agent del browser che carica la pagina: se esso corrisponde all’applicazione, non viene caricato l’header, altrimenti viene caricata normalmente l’intera pagina. Eccovi i due screen dimostrativi:

Spero che questo tips possa tornarvi utile, a me è servito per rendere l’aspetto grafico dell’applicazione più pulito e professionale!

Al prossimo “XCode Tips&Tricks”!

Appena sono state aperte le porte dell’Apple Store di New York per la vendita del nuovo iPad, Apple ha rilasciato la versione finale dell’SDK, che giunge così alla versione 3.2 e supporta appieno la creazione di applicazioni per iPhone e iPad!

Non vi sono particolari differenze tra questa versione e la GM (Gold Master) di qualche giorno fa, e non sono emerse novità di alcun genere.

Vi ricordo che per installare l’SDK 3.2 è necessario Mac OS X Snow Leopard, mentre potete scaricarlo da questo indirizzo.

Eccoci ancora una volta con un piccolo tip sulle UIAlertView. Questi sono sicuramente tra i componenti più utilizzati e anche più versatili, ma non è facile cambiarne l’aspetto grafico.

Può capitare, infatti, che la classica UIAlertView “stoni” con il design della nostra applicazione, rendendo il tutto un po’ meno piacevole. Personalizzarne il colore e lo stile non è facile ed immediato, ma ho trovato su Internet una classe che permette di creare delle alert con colori personalizzati, semplificandoci davvero il lavoro!

Eccovi un esempio di ciò che tale classe permette di fare:

Per implementare questo componente create una nuova classe di nome “CustomAlert” e inserite nel file .h questo codice:

#import <UIKit/UIKit.h>
 
@interface CustomAlert : UIAlertView{
 
}
 
+ (void)setBackgroundColor:(UIColor *)background withStrokeColor:(UIColor *) stroke;
 
@end

e nel file .m questo codice:

#import "CustomAlert.h"
 
@interface CustomAlert (Private)
 
- (void) drawRoundedRect:(CGRect) rect inContext:(CGContextRef)
context withRadius:(CGFloat) radius;
 
@end
 
static UIColor *fillColor = nil;
static UIColor *borderColor = nil;
 
@implementation CustomAlert
 
+ (void) setBackgroundColor:(UIColor *) background
			withStrokeColor:(UIColor *) stroke
{
	if(fillColor != nil)
	{
		[fillColor release];
		[borderColor release];
	}
 
	fillColor = [background retain];
	borderColor = [stroke retain];
}
 
- (id)initWithFrame:(CGRect)frame
{
    if((self = [super initWithFrame:frame]))
	{
        if(fillColor == nil)
		{
			fillColor = [[UIColor blackColor] retain];
			borderColor = [[UIColor colorWithHue:0.625
									  saturation:0.0 brightness:0.8 alpha:0.8]
						   retain];
		}
    }
 
    return self;
}
 
- (void)layoutSubviews
{
	for (UIView *sub in [self subviews])
	{
		if([sub class] == [UIImageView class] && sub.tag == 0)
		{
			// The alert background UIImageView tag is 0,
			// if you are adding your own UIImageView's
			// make sure your tags != 0 or this fix
			// will remove your UIImageView's as well!
			[sub removeFromSuperview];
			break;
		}
	}
}
 
- (void)drawRect:(CGRect)rect
{
	CGContextRef context = UIGraphicsGetCurrentContext();
 
	CGContextClearRect(context, rect);
	CGContextSetAllowsAntialiasing(context, true);
	CGContextSetLineWidth(context, 0.0);
	CGContextSetAlpha(context, 0.8);
	CGContextSetLineWidth(context, 2.0);
	CGContextSetStrokeColorWithColor(context, [borderColor CGColor]);
	CGContextSetFillColorWithColor(context, [fillColor CGColor]);
 
	// Draw background
	CGFloat backOffset = 2;
	CGRect backRect = CGRectMake(rect.origin.x + backOffset,
								 rect.origin.y + backOffset,
								 rect.size.width - backOffset*2,
								 rect.size.height - backOffset*2);
 
	[self drawRoundedRect:backRect inContext:context withRadius:8];
	CGContextDrawPath(context, kCGPathFillStroke);
 
	// Clip Context
	CGRect clipRect = CGRectMake(backRect.origin.x + backOffset-1,
								 backRect.origin.y + backOffset-1,
								 backRect.size.width - (backOffset-1)*2,
								 backRect.size.height - (backOffset-1)*2);
 
	[self drawRoundedRect:clipRect inContext:context withRadius:8];
	CGContextClip (context);
 
	//Draw highlight
	CGGradientRef glossGradient;
	CGColorSpaceRef rgbColorspace;
	size_t num_locations = 2;
	CGFloat locations[2] = { 0.0, 1.0 };
	CGFloat components[8] = { 1.0, 1.0, 1.0, 0.35, 1.0, 1.0, 1.0, 0.06 };
	rgbColorspace = CGColorSpaceCreateDeviceRGB();
	glossGradient = CGGradientCreateWithColorComponents(rgbColorspace,
														components, locations, num_locations);
 
	CGRect ovalRect = CGRectMake(-130, -115, (rect.size.width*2),
								 rect.size.width/2);
 
	CGPoint start = CGPointMake(rect.origin.x, rect.origin.y);
	CGPoint end = CGPointMake(rect.origin.x, rect.size.height/5);
 
	CGContextSetAlpha(context, 1.0);
	CGContextAddEllipseInRect(context, ovalRect);
	CGContextClip (context);
 
	CGContextDrawLinearGradient(context, glossGradient, start, end, 0);
 
	CGGradientRelease(glossGradient);
	CGColorSpaceRelease(rgbColorspace);
}
 
- (void) drawRoundedRect:(CGRect) rrect inContext:(CGContextRef) context
			  withRadius:(CGFloat) radius
{
	CGContextBeginPath (context);
 
	CGFloat minx = CGRectGetMinX(rrect), midx = CGRectGetMidX(rrect),
	maxx = CGRectGetMaxX(rrect);
 
	CGFloat miny = CGRectGetMinY(rrect), midy = CGRectGetMidY(rrect),
	maxy = CGRectGetMaxY(rrect);
 
	CGContextMoveToPoint(context, minx, midy);
	CGContextAddArcToPoint(context, minx, miny, midx, miny, radius);
	CGContextAddArcToPoint(context, maxx, miny, maxx, midy, radius);
	CGContextAddArcToPoint(context, maxx, maxy, midx, maxy, radius);
	CGContextAddArcToPoint(context, minx, maxy, minx, midy, radius);
	CGContextClosePath(context);
}
 
- (void)dealloc
{
    [super dealloc];
}
 
@end

Per utilizzare delle UIAlertView personalizzate dovrete utilizzare questa classe nello stesso modo in cui utilizzare gli alert tradizionali, eccovi un esempio:

	// Imposto i colori
	[CustomAlert setBackgroundColor:[UIColor blueColor] withStrokeColor:[UIColor cyanColor]];
	// Creo e visualizzo l'alert personalizzata
	CustomAlert *alert=[[CustomAlert alloc] initWithTitle:@"Prova!" message:@"Eccovi un'alert personalizzata.." delegate:self cancelButtonTitle:@"OK" otherButtonTitles:nil];
	[alert show];
	[alert release];

Questo è l’unico modo che ho trovato per personalizzare il colore di una UIAlertView, e devo dire che i risultati non sono male. Se siete a conoscenza di altri metodi fatemelo sapere nei commenti!

Aggiornamento 21/01/2011: il codice è stato aggiornato (come nella versione originale) per funzionare anche con iOS 4.2

I meriti di tale classe sono di kwigbo, trovate l’articolo originale a questo indirizzo.

In questo nuovo tutorial vedremo come realizzare una cosa molto particolare, che potrà tornare utile soprattutto quando distrubuirete l’applicazione a diversi beta tester.

Vedremo, infatti, come inserire all’interno del nostro progetto (oltre al classico numero di versione dell’applicazione) un numero di build progressimo, insieme anche alla data della build in questione.

Utilizzeremo uno script automatico, che ad ogni build creata aumenterà il numero di build e aggiornerà la data della build Potremo, così, avere sempre sotto controllo l’esatta versione della nostra applicazione, in modo da avere un controllo completo su tutte le versioni.

Buon tutorial!

1. Inseriamo lo script

Entriamo nel progetto in cui vogliamo inserire l’incremento automatico del numero di versione. Facciamo clic con il tasto destro sul nome del nostro progetto e scegliamo “Add -> New Build Phase -> New Run Script Build Phase”.

Si aprirà una schermata come questa:

in cui dovremo andare ad inserire lo script necessario. Eccovelo:

#!/bin/bash
# Auto Increment Version Script
buildPlist="prova-Info.plist"
CFBuildNumber=$(/usr/libexec/PlistBuddy -c "Print CFBuildNumber" $buildPlist)
CFBuildNumber=$(($CFBuildNumber + 1))
<div id="_mcePaste">/usr/libexec/PlistBuddy -c "Set :CFBuildNumber $CFBuildNumber" $buildPlist
CFBuildDate=$(date)
/usr/libexec/PlistBuddy -c "Set :CFBuildDate $CFBuildDate" $buildPlist</div>

Ovviamente dovete modificare la stringa buildPlist=”prova-Info.plis”, inserendo il nome del vostro file “.plist” (che sarà nella forma “nome_progetto-Info.plist”).

Chiudete pure tale finestra.

2. Inseriamo le variabili necessarie

Spostatevi, ora, nella cartella “Resources” ed aprite il file “xxx-Info.plist” che trovate al suo interno (dove xxx è il nome del vostro progetto).

Utilizzando il “+” che appare di fianco alle voci già presenti, inserite due nuovi valori, rispettivamente chiamati “CFBuildDate” e “CFBuildNumber“. Non c’è bisogno che inseriate dei valori per queste due voci, in quanto verranno create automaticamente dallo script. Ecco come deve essere il vostro file “.plist”:

Potete notare che è già presente la stringa “Bundle version“, che identifica la versione della nostra applicazione. Sarà anche questo un valore che andremo a leggere. Salvate il file e chiudetelo pure.

3. Inseriamo il codice necessario

Non ci resta che inserire quelle poche istruzioni che ci permetteranno di leggere il numero di versione, il numero di build e la data dell’ultima build. Inserite, dove vi serve, il seguente codice:

1
2
3

NSString *versione = [[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleVersion"];
NSString *build = [[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBuildNumber"];
NSString *data = [[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBuildDate"];

Come vedete abbiamo ottenuto tre stringhe con i rispettivi tre valori, che potrete utilizzare a vostro piacimento!

Se Avete Problemi, questo è il nostro file di progetto.

Nota: per visualizzare lo script inserito espandete l’elemento “Targets” del progetto e fate doppio clic su “Run Script“.

La guida è stata creata da Andrea Busi per “Bubi Devs”, prendendo spunto da questa guida: “Auto Increment Build Number & Date in XCode iPhone Project“. I meriti, quindi, sono del legittimo autore.

Solo qualche giorno fa vi avevamo spiegato come inserire più bottoni in una UIAlertView.

Subito dopo ho ricevuto via Twitter una richiesta da “Luigix95“, che mi chiedeva come inserire una UITextField all’interno di un UIViewAlert, in modo da permettere all’utente di inserire del testo (in pratica un comportamente simile a quello che avviene quando scaricate un’applicazione e AppStore vi richiede la password).

Ecco, quindi, il procedimento da seguire.

Nel file “.h” della vostra classe inserite la dichiarazione di una UITextField, eccovi un esempio:

1
2
3
4
5

@interface provaAlertViewController : UIViewController <UIAlertViewDelegate, UITextFieldDelegate> {
  UITextField *textField;
}
 
@end

Come vedete abbiamo definito una text field (riga 2). Ricordatevi, inoltre, di inserire i due delegati “UIAlertViewDelegate” e “UItextFieldDelegate”, che ci permetteranno di interagire con la UIAlertView e con la UITextField.

Nel file “.m” definiamo (dove vi serve) una UIAlertView, e inseriamo anche la text field appena definita:

1
2
3
4
5
6
7
8
9
10
11
12

 UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"Inserisci il tuo nome" message:@" " delegate:self cancelButtonTitle:@"Annulla" otherButtonTitles:@"OK", nil];
 // definiamo e inseriamo la TextField
 textField = [[UITextField alloc] initWithFrame:CGRectMake(20.0, 45.0, 245.0, 25.0)];
 textField.delegate = self;
 [textField setBackgroundColor:[UIColor whiteColor]];
 [alertView addSubview:textField];
 // lo spostiamo un po' in alto, altrimenti viene nascosto dalla tastiera
 CGAffineTransform alza = CGAffineTransformMakeTranslation(0.0, 100.0);
 [alertView setTransform:alza];
 // mostriamo l'alert view
 [alertView show];
 [alertView release];

Come potete vedere, alla riga 3 abbiamo istanziato una UITextField con delle dimensioni che possano stare nell’UIAlertView. Settiamo, poi, il delegato (riga 4, che vedremo fra poco a cosa servirà), il colore (riga 5) e la inseriamo poi nell’alert (riga 6).

Alla riga 8 definiamo una trasformazione, che sposterà verso l’alto la nostra UIAlertView, in modo che essa non venga coperta dalla tastiera che apparirà per scrivere nella text field.

Ci mancano solo due semplici metodi da inserire, due metodi appartenenti ai delegati che abbiamo definito nell’intestazione della classe. Eccoli:

1
2
3
4
5
6
7
8
9
10
11
12

- (void)alertView:(UIAlertView *)actionSheet clickedButtonAtIndex:(NSInteger)buttonIndex {
 // l'utente ha selezionato si, quindi vuole azzerare i punteggi
 if (buttonIndex == 1) {
 NSString *textValue = textField.text;
 NSLog(@"testo: %@",textValue);
 }
}
 
- (BOOL)textFieldShouldReturn:(UITextField *)textField{
 [textField resignFirstResponder];
 return YES;
}

Il primo metodo ci permette di capire il bottone che è stato premuto (nel nostro caso controlliamo che sia stato premuto “Ok”), e ricaviamo il testo inserito, stampandolo semplicemente nella console di debug.

Il secondo metodo, invece, lo avrete già visto più volte, e permette alla tastiera di chiudersi quando si clicca su “Return” (o “Done”) della tastiera.

Spero di avervi mostrato qualcosa che vi possa tornare utile, se avete richieste scrivetemi utilizzando questo form oppure direttamente su Twitter! Alla prossima!