Xcode文档版本更新2010-06-24

新鲜出炉的文档更新：

苹果在北京时间2010年6月24日凌晨3点多，更新了Xcode的文档RSS，发布了5只新版文档，分别是：

• iOS4的文档，版本号：33.80.0
• Xcode 3.2的文档，版本号：406.2.0
• Mac OS X 10.6 Core文档，版本号：406.1.0
• Mac OS X Java文档，版本号：406.2.0
• Mac OS X Legacy文档，版本号：7.2.0

分别位于iOS4文档RSS，Xcode 3.2文档RSS和Snow Leopard文档RSS下。

Xcode文档自动安装脚本

其实没有标题说的那么神奇啦。情况是这样的，每次升级Xcode或iPhone SDK，之前下载的文档会全部删掉重来。这对于网络很快的童鞋可能不是什么大问题，但是对于我这种小水管，下载n GiB的文档就是一个沉重的负担了。

所以，我之前在Wiki写过文章，讲述如何离线安装Xcode的文档。不过最近，从iPhone SDK 4 Beta1~4, GM一路装下来，每次都要重复输入那么多的命令，实在是麻烦之极。被迫无奈之下，这次写了个脚本来解决问题。

方法很简单，把iPhone文档和Mac文档分别置于iOS和Mac两个子目录中，然后创建下面的脚本：

#!/bin/bash

macdocs='/Developer/Documentation/DocSets/'
iosdocs='/Developer/Platforms/iPhoneOS.platform/Developer/Documentation/DocSets/'

# Function: Extract Docs From Xar Archives
do_extract() {
 echo In directory: $1
 echo Extract xars...
 for file in `ls -1`
 do
   xar -xf $file
 done
 
 echo Delete xars...
 rm -f *.xar

 echo Change ownerships...
 for dir in `ls -1`
 do
   chown -R -P _devdocs $dir
   chmod 775 $dir
 done
}

# Delete Old Docs and Copy xar to Mac Doc Dir
echo Operation Start.
echo
echo Deleting Old Mac Docsets...
rm -rf ${macdocs}*.docset
echo Copying xars to $macdocs
cp Mac/*.xar $macdocs

# Delete Old Docs and Copy xar to iOS Doc Dir
echo Deleting Old iOS Docsets...
rm -rf ${iosdocs}*.docset
echo Copying xars to $iosdocs...
cp iOS/*.xar $iosdocs

# Goto Mac Doc Dir and Extract Docs.
echo Start to Extract Mac Docs...
cd $macdocs
do_extract $macdocs

# Goto iOS Doc Dir and Extract Docs.
echo Start to Extract iOS Docs...
cd $iosdocs
do_extract $iosdocs

echo All Done.

你可以把脚本命名为任何名字，比如docsetup.sh，赋予执行权限。升级完毕Xcode之后，进入文档目录，执行：

sudu ./docsetup.sh

等待片刻，文档就全部安装好了。

上面的那个脚本没有任何错误捕获机制，所以，用的时候要谨慎。另外，脚本的意思很简单，在执行前，你先了解一下脚本到底在你的系统里做了些什么事情，然后再决定要不要用。本人不对错误执行脚本造成的任何损失而负责的哦，所以请小心使用。 :)

Xcode的文档浏览器

Xcode的文档都他妈的要从网上RSS下载，真是。。。Orz啊，全部文档有大约2G，全部通过网络下载，这让我情何以堪啊；而且苹果网站的速度，通常都不是很快的。。。最令人崩溃的是，每次升级Xcode，都会把旧文档全部干掉。。。

另外，有一点，在升级到iPhone SDK 3.2之后，在文档浏览器里看Xcode的几个视频，终于不会导致Xcode崩溃了，Orz。。。

隧道管家(Mac Only)

今天不小心发现了一个很好用的玩意儿：SSH Tunnel Manager。这个东东加上FoxyProxy那就无敌了。网站上提供的二进制文件是PPC平台的，要安装Rosetta才能运行。幸运的是，这东东提供了源代码！Xcode直接编译没有任何问题。我把里面的ppc版的ssh主程序替换成了我系统里的ssh，因此Leopard可能用不了。不过我下面的那个包里已经包含了源代码，Leopard的用户可以自行替换里面的ssh，重新编译。不过如果你没有安装Xcode的话，理论上你也可以直接替换SSH Tunnel Manager.app/Contents/Resources/ssh。

下面是程序运行的截图。


下载隧道管家和源代码

Xcode 3 Unleashed

Mac平台的软件开发因为Mac的流行和革命性的iPhone OS而成为最有发展潜力的领域之一。不过Mac开发资料除了寥寥的几本老书之外（当然，去年出了Learning Cocoa with Objective-C的中文版），实在是不多。我之前也曾在VeryCD上推荐过一些Mac开发系列书籍。

不过最近有很多Mac和iPhone相关的开发书籍在出版中。而Xcode 3 Unleashed是其中比较重磅的一本（之前一本重磅的书是：Cocoa Programming for Mac OS X）。到年底的时候，还有一本Mac编程基础的书籍也将要出版：Objective-C 2.0 Programming Language。

最近Xcode 3 Unleashed的电子版出现，这对Mac开发人员和有兴趣从事Mac软件开发的爱好者们来说是一件大大的好事。我有幸能够简单的翻阅了一下这个电子版，实在是非常的棒。如果配合年底将要出版的“Objective-C 2.0 Programming LanguageProgramming in Objective-C 2.0”一起阅读那就更好了。（抱歉，我写错书名了。）

学习时间到了，你准备好了吗？ ;)

学习Objective-C

Objective-C

Objective-C是编写Mac软件使用的主要语言。如果你对面向对象的基本概念和C语言有所了解，学习Objective-C也不会很困难。如果你不了解C语言，你应该首先阅读C语言教程（英文/中文）。

本教程的文字和图片均由Scott Stevenson创作。

Copyright © 2008 Scott Stevenson

---

第1部分 方法调用

为了最快速的起步，让我们先看几个简单的例子。调用一个对象的方法的基本语法如下：

[object method];
[object methodWithInput:input];

方法可以返回一个值：

output = [object methodWithOutput];
output = [object methodWithInputAndOutput:input];

你还可以调用类方法，这也是你创建对象时所做的事情。在下面的这个例子中，我们对NSString类调用了string方法，这将返回一个新的NSString对象：

id myObject = [NSString string];

id类型意味着myObject变量可以引用任何类型的对象，因此该对象所属的实际的类和方法实现在编译程序的时候是未知的。

在上面的例子中，对象的类型显然属于NSString，因此我们也可以这样写：

NSString* myString = [NSString string];

现在，myString就成了一个NSString变量了，因此，如果我们调用了这个对象不支持的方法，编译器就会发出警告。

注意，对象类型的右侧有一个星号。所有的Objective-C对象变量都是指针类型。id类型被预定义为指针类型，因此不需要加星号了。

嵌套消息

在很多语言中，嵌套方法或函数调用看起来类似这样：

function1 ( function2() );

function2的结果作为参数传递给function1。在Objective-C中，嵌套方法看起来类似这样：

[NSString stringWithFormat:[prefs format]];

在同一行中，应该尽量避免多于两层的消息调用。这样很容易导致代码难以阅读。

多输入方法

有些方法可以有多个输入。在Objective-C中，一个方法名可以跟分隔成多段。在头文件中，一个多输入方法的声明看起来类似下面这行：

-(BOOL)writeToFile:(NSString *)path atomically:(BOOL)useAuxiliaryFile;

你可以像这样调用这个方法：

BOOL result = [myData writeToFile:@"/tmp/log.txt" atomically:NO];

这并不是有名字的参数。在运行时系统中，方法名实际上是writeToFile:atomically:。

第2部分 访问器

在Objective-C中，所有的实例变量默认都是私有的，因此在大多数情况下，你需要使用访问器来获取和设置实例变量的值。现在有两种语法可以实现。下面的这个是传统的1.x语法：

[photo setCaption:@"Day at the Beach"];
output = [photo caption];

第二行代码并不是直接读取实例变量，而是调用了一个名为caption的方法。在大多数情况下，你无需在Objective-C的取值器上加上"get"前缀。

只要你看到方括号，就要知道这是在向对象或类发送消息。

点操作符

用点来操作取值器和赋值器是与Mac OS X 10.5一起发布的Objective-C 2.0的新特征：

photo.caption = @"Day at the Beach";
output = photo.caption;

你可以随便使用哪种风格，但是在同一个项目中只能使用其中的一种。点操作符只能用来处理取值器和赋值器，不能用来调用常规的方法。

第3部分 创建对象

主要有两种方法可以用来创建对象。其中的一种你已经在之前看到过了：

NSString* myString = [NSString string];

这是一种方便的自动创建对象的方法。在这个例子中，你创建了一个自动释放(autorelease)的对象，我们后文会做出进一步解释。在很多情况下，你需要用手动方法创建一个对象：

NSString* myString = [[NSString alloc] init];

这是一个嵌套方法调用。第一个是对NSString调用alloc方法。这是一个相对底层的调用，作用是分配内存和实例化对象。

第二次是对新对象调用了init方法。init的实现通常是进行基本设置，例如创建实例变量等。作为类的客户，你是无法知道这个过程的细节的。（The details of that are unknown to you as a client of the class.  这句话的翻译还存在疑问）

在一些情况下，你可能使用一个不同版本的init方法，以接受参数输入。

NSNumber* value = [[NSNumber alloc] initWithFloat:1.0];

第4部分 内存管理基础

如果你在为Mac OS X写程序，你可以选择是否启用垃圾收集。通常，启用它意味着你无需考虑内存管理，除非遇到了非常复杂的情况。

然而，你可能不总是能在支持垃圾收集的环境下工作。在这种情况下，你就需要知道一些关于内存管理的基本概念了。

如果你用手工alloc风格创建了一个对象，你需要在后面释放(release)这个对象。你不能手动释放一个自动释放的对象，如果你这么做会导致应用程序崩溃。

下面有两个例子：

// string1 会自动释放
NSString* string1 = [NSString string];

// 不再使用时需要手工释放
NSString* string2 = [[NSString alloc] init];
[string2 release];

在本教程中，你可以认为自动释放的对象会在当前函数调用完成时消失。

关于内存管理还有很多内容需要学习，但是在此之前先介绍几个概念，以帮助我们理解。

第5部分 设计类的接口

Objective-C创建一个类的语法非常简单。通常分为两部分。

类的接口通常保存在ClassName.h文件中，定义了实例变量和公有方法。

类的实现保存在ClassName.m文件中，包含了方法的实际代码。同时还定义了私有方法，这些方法在类的外部是不可见的。

下面就是一个接口的示例。这个类名为Photo，因此文件名为Photo.h：

#import <Cocoa/Cocoa.h>

@interface Photo : NSObject {
NSString* caption;
NSString* photographer;
}
@end

首先我们导入了Cocoa.h，把Cocoa程序的所有基本类都拖进来。#import由#include衍生而来，不同的是它能保证一个头文件不被多次包含。

@interface只是了这是Photo类的声明段。冒号指示了Photo类的超类是NSObject。

在大括号内，有两个实例变量：caption和photographer，都属于NSString类。实例变量可以是任何对象类型，包括id。

最后，@end标志了类定义的结束。

添加方法

让我们为实例变量添加取值器：

#import <Cocoa/Cocoa.h>

@interface Photo : NSObject {
NSString* caption;
NSString* photographer;
}

- caption;
- photographer;
@end

记住，Objective-C的取值器通常不加get前缀。方法名前面的减号表明它是实例方法；加号则表明是类方法。

默认情况下，编译器假设方法返回id类型的对象，所有输入值也是id类型。因此，上面的代码从技术上讲是正确的，但是通常我们不这么写。让我们为返回值指定类型：

#import <Cocoa/Cocoa.h>

@interface Photo : NSObject {
NSString* caption;
NSString* photographer;
}

- (NSString*) caption;
- (NSString*) photographer;

@end

现在，加入赋值器：

#import <Cocoa/Cocoa.h>

@interface Photo : NSObject {
NSString* caption;
NSString* photographer;
}

- (NSString*) caption;
- (NSString*) photographer;

- (void) setCaption: (NSString*)input;
- (void) setPhotographer: (NSString*)input;

@end

赋值器没有返回值，因此把类型指定为void。

第6部分 类的实现

让我们来创建一个实现，首先从赋值器开始：

#import "Photo.h"

@implementation Photo

- (NSString*) caption {
return caption;
}

- (NSString*) photographer {
return photographer;
}

@end

这段代码由@implementation和类名起始，以@end结束，这与接口的定义方法类似。所有的方法定义必须在这两个语句之间。

如果你曾经写过程序，取值器的实现看起来可能比较眼熟，所以我们重点看赋值器，理解它需要更多的解释。

- (void) setCaption: (NSString*)input
{
【caption autorelease】; //用中文标点是为了避免本行无法显示。请将中括号改成英文中括号。
caption = [input retain];
}

- (void) setPhotographer: (NSString*)input
{
[photographer autorelease];
photographer = [input retain];
}

每个赋值器处理两个变量。第一个是对已有对象的引用，第二个是一个新的input对象。在启用垃圾收集的环境中，我们可以直接设置新值：

- (void) setCaption: (NSString*)input {
caption = input;
}

但是如果你不能使用垃圾收集，你需要释放(release)旧对象，保留(retain)新对象。

事实上有两种方法可以解除一个对象的引用：释放(release)和自动释放(autorelease)。标准的release方法会立刻删除引用。autorelease方法则是尽快的释放引用，但是这个对象在当前函数结束前绝对不会消失（除非你使用了自定义代码特意改变这种行为）。

在赋值器中使用autorelease方法会更加安全，因为变量的新值和旧值可能指向同一个对象。你肯定不希望立刻释放那个你即将保留的对象。

这可能看起来很混淆，不过随着学习的进行，你就能渐渐理解了。你现在不需要完全理解这些内容。

Init

我们可以创建一个init方法来设置实例变量的初始值：

- (id) init
{
if ( self = [super init] )
{
[self setCaption:@"Default Caption"];
[self setPhotographer:@"Default Photographer"];
}
return self;
}

除了第二行看起来比较特别以外，这段代码很容易理解。通过一个等号，将[super init]的值传递给self。

这条语句只是让超类进行它们自己的初始化。if语句是为了在设置默认值之前确认初始化是否已经成功完成。

Dealloc

将一个对象从内存中移除的时候会调用dealloc方法。这时是释放所有子实例变量的最佳时机：

- (void) dealloc
{
【caption release】;
[photographer release];
[super dealloc];
}

前面两行，我们只是向两个实例变量发送了release消息。这里我们不需要使用autorelease了，标准的release方法会更快。

最后一行非常重要。我们发送[super dealloc]消息，让超类进行清理工作。如果我们不加这行代码，对象就无法被移除，这就导致了内存泄漏。

dealloc方法在启用垃圾收集时是不会调用的。你可以实现finalize方法来实现类似的功能。

第7部分 内存管理进阶

Objective-C的内存管理系统被称为引用计数。你所要做的事跟踪引用，实际的内存释放工作是由运行时系统来完成的。

简单的说，首先alloc一个对象，可能需要retain一段时间，然后针对每个alloc/retain发送release消息。因此，如果你使用了alloc和retain各一次，你需要release两次。

这就是引用计数的理论。但是实际应用中，只有两个理由需要创建一个对象：

1. 把它保留为实例变量


2. 在函数中临时使用

在大多数情况下，实例变量的赋值器应该把旧对象自动释放(autorelease)并保留(retain)新对象。你只需要确保在后面dealloc它。

实际的内存管理工作其实就是在函数中管理本地引用。规则只有一条：如果你用alloc或copy创建了一个对象，在函数的最后向它发送一条release或autorelease消息。如果你用其他方法创建了一个对象，无需额外处理。

下面是第一种情况，管理一个实例变量：

- (void) setTotalAmount: (NSNumber*)input
{
[totalAmount autorelease];
totalAmount = [input retain];
}

- (void) dealloc
{
[totalAmount release];
[super dealloc];
}

下面是另一种情况，本地引用。我们只需要释放使用alloc方法创建的对象：

NSNumber* value1 = [[NSNumber alloc] initWithFloat:8.75];
NSNumber* value2 = [NSNumber numberWithFloat:14.78];

// 仅释放 value1, 不需要释放 value2
[value1 release];

下面是一个综合应用的例子：使用本地引用把对象设置为一个实例变量：

NSNumber* value1 = [[NSNumber alloc] initWithFloat:8.75];
[self setTotal:value1];

NSNumber* value2 = [NSNumber numberWithFloat:14.78];
[self setTotal:value2];

[value1 release];

注意到，不管本地引用被设置成实例变量与否，管理规则是完全一样的。你不需要考虑赋值器是如何实现的。

如果你理解这些内容，你对Objective-C内存管理的理解已经达到90%了。

第8部分 回显(Logging)

Objective-C中，要向控制台回显消息是很简单的。事实上，NSLog()函数几乎与C的printf()函数完全一样，除了它能使用一个%@标记，来回显对象。

NSLog ( @"The current date and time is: %@", [NSDate date] );

你可以在控制台上回显一个对象。NSLog函数调用对象的description方法，并打印返回的NSString对象。你可以在自己的类中覆盖description方法，返回一个自定义字符串。

第9部分 属性

在我们之前为caption和author编写访问器方法的时候，你可能已经注意到了代码非常直观易懂，甚至可以被泛化处理（Generalized）。

属性是Objective-C的一项特征，允许我们自动生成访问器，另外还有一些的额外好处。让我们来用属性来处理Photo类。

这是之前的代码：

#import <Cocoa/Cocoa.h>

@interface Photo : NSObject {
NSString* caption;
NSString* photographer;
}

- (NSString*) caption;
- (NSString*) photographer;

- (void) setCaption: (NSString*)input;
- (void) setPhotographer: (NSString*)input;

@end

下面是使用了属性之后的代码：

#import <Cocoa/Cocoa.h>

@interface Photo : NSObject {
NSString* caption;
NSString* photographer;
}

@property (retain) NSString* caption;
@property (retain) NSString* photographer;

@end

@property在Objective-C中指示了变量的声明。括号中的retain指示了赋值器需要保留input值；这一行的其他部分指示了属性的类型和名称。

现在让我们来看看类的实现：

#import "Photo.h"
@implementation Photo

@synthesize caption;
@synthesize photographer;

- (void) dealloc
{
【caption release】;
[photographer release];
[super dealloc];
}

@end

@synthesize让编译器为我们自动生成赋值器和取值器，这样，我们只需为这个类实现dealloc方法。

访问器只会在他们不存在的情况下才被生成，所以请放心的对一个属性使用@synthesize，然后在你需要的时候实现自定义的取值器和赋值器。编译器会填补任何方法的空白。

第10部分 对Nil调用方法

在Objective-C中，你来对象在功能上等价于其他很多语言中的NULL指针。区别是可以对nil调用方法，而不致导致程序崩溃或抛出异常。

这种技术以多种不同的形式被用在框架(frameworks)中，但是目前你需要知道的是，在对一个对象调用方法的时候，无需检验它是不是nil。如果你对一个能返回对象的nil调用方法，你将得到的返回值是nil。

我们还可以使用这种技术稍稍改进一下我们的dealloc方法：

- (void) dealloc
{
self.caption = nil;
self.photographer = nil;
[super dealloc];
}

这是可行的，因为我们把nil设置为一个实例变量了。赋值器只是保留了nil(它什么都不会做)并释放了旧值。这种方法对dealloc来说通常更好些，因为这样，变量就不会指向一个对象之前所在的随机数据位置了。

注意，我们使用了self.<var>的语法形式，这意味着我们使用了赋值器，并释放了内存。如果我们仅仅想下面这样直接赋值，将会导致内存泄漏。

// 错误。这将导致内存泄漏。
// 使用self.caption来处理访问器
caption = nil;

第11部分 分类(Categories)

分类是Objective-C中最有用的特征之一。简而言之，分类允许你为一个已有的类添加方法而无需派生子类或了解类的更多实现细节。这一点非常有用，因为你能为内建的对象添加方法。如果你希望为你的程序中的所有NSString实例添加一个方法，你只需要添加一个分类。你无须通过派生子类来自定义所有的细节。

例如，如果要为NSString添加一个发方法来检查它是否是一个URL，你可以这样写：

#import <Cocoa/Cocoa.h>

@interface NSString (Utilities)
- (BOOL) isURL;
@end

这和定义一个类很相似。区别是不需要指定超类，且需要一个用括号包围的分类名称。你可以使用任何名称，不过最好这个名字能够指示方法的用途。

下面是方法实现。注意，这不是一个好的URL探测实现。我们只是用这个示例来展示分类的概念：

#import "NSString-Utilities.h"

@implementation NSString (Utilities)

- (BOOL) isURL
{
if ( [self hasPrefix:@"http://"] )
return YES;
else
return NO;
}

@end

现在你就能对所有NSString对象使用这个方法了。下面这段代码能在控制台打印"string1 is a URL"。

NSString* string1 = @"http://pixar.com/";
NSString* string2 = @"Pixar";

if ( [string1 isURL] )
NSLog (@"string1 is a URL");
if ( [string2 isURL] )
NSLog (@"string2 is a URL");

与派生子类不同的是，分类不能增加实例变量。不过你可以使用分类来覆盖一个已有的方法，不过你得非常小心。

记住，当你使用分类对一个类进行修改的时候，它会影响这个类在程序中的所有实例。

总结

本文只是Objective-C的概览。正如你所看淡的，这种语言是很容易学习的，并没有很多特殊的语法需要学习，同样的约定在Cocoa中会不断的用到。

如果你想要实践一下这些例子，可以下载下面的项目文件并通读源代码。

学习Objective-C Xcode 3.0 项目文件(56k)

谢谢！

---

(本翻译用 Prism + Google Docs 制作)

原文地址：http://cocoadevcentral.com/d/learn_objectivec/

版权说明：本文来自Cocoa Dev Central， 原文版权在上文已经给出。关于那个捐助信息，我只是照原文翻译，如果你真的有意捐献原文作者，请访问原文，地址在上面也已经给出。因为不知道原文的授权方 式，我也懒得联系原作者询问版权事宜，因此本翻译的文字内容暂时按照Public Domain（公有域）方式授权使用，即，本人放弃本翻译的版权。文中的所有图片均来自原文，版权归原作者所有。

免责声明：本人不保证翻译的正确性。本人也不对因使用本翻译造成的直接或间接的损失负责。

（Venj@iLoveMac.cn 译）