Sublime text 2 setup

最近常使用 Sublime Text 來編輯一些文件，有時候，電腦重灌就忘了一些常用套件是怎麼裝旳，以下列一些常用的套件的URL吧！

Sublime Text 2 http://www.sublimetext.com/2
Package Control https://sublime.wbond.net/installation#st2
Markdown preview https://github.com/revolunet/sublimetext-markdown-preview

如何新增一筆聯絡人資料到通訊錄

接著上一篇如何存取iPhone 通訊錄裡的資料，接著就是要新增一筆資料寫入通訊錄了。其實很簡單，只要呼叫 ABPersonCreate(); 便可產生一筆空白資料，多項資料(MultiProperty)比單項資料(Property)多了一道處理程序；直接來看範例～

 NSString *firstName, *lastName, ... ;
 NSDictionary *emails;
 ...

 //產生 AddressBook 物件
 ABAddressBookRef addressBookObj = ABAddressBookCreateWithOptions(NULL, NULL);

 //產生一筆空白聯絡人資料
 ABRecord record = ABPersonCreate();

 //處理單項資料 (property)
 ABRecordSetValue(record, kABPersonFirstNameProperty, CFBridgingRetain(firstName) , nil);
 ABRecordSetValue(record, kABPersonLastNameProperty, CFBridgingRetain(lastName) , nil);

 //處理多項資料 (MultiProperty)
 NSArray *allLabels = [emails allKeys];
 ABMutableMultiValueRef multiValue = ABMultiValueCreateMutable(kABMultiStringPropertyType);
 for(NSString *label in allLabels) {
    NSString *value = [emails objectForKey:label];
    ABMultiValueAddValueAndLabel(multiValue, CFBridgingRetain(value), CFBridgingRetain(label), NULL);
 }
 ABRecordSetValue(record, kABPersonEmailProperty, multiValue, nil);

 //寫入&儲存
 ABAddressBookAddRecord(addressBookObj,record,nil);
 ABAddressBookSave(addressBookObj);

在上面的例子中，是直接產生一筆空白的聯絡人資料；若是換成即有存在的舊資料，也是可以的，但在處理多項資料時，若遇到已經存在的label，不可使用 ABMultiValueAddValueAndLabel，請改用 ABMultiValueReplaceValueAtIndex 去處理；

除了，直接寫入通訊錄外， framework 另外提供了預設的聯絡人的輸入UI，共有二套，一為 "ABNewPersonViewController"；另一為 "ABUnknownPersonViewController"；差別在於後者可以選擇覆寫即有的資料。

ABNewPersonViewController 的範例～

 ABNewPersonViewController *newPersonVC = [[ABNewPersonViewController alloc] init];
 ABRecordRef aNewRecord = ABPersonCreate();

 newPersonVC.newPersonViewDelegate = self;
 newPersonVC.addressBook = addressBookObj;
 newPersonVC.displayedPerson = aNewRecord;

 [currentNavigationViewController pushViewController:newPersonVC animated:YES];

ABNewPersonViewController 的範例～

 ABUnknownPersonViewController *unknowPersonVC = [[ABUnknownPersonViewController alloc]init];
 unknowPersonVC.unknownPersonViewDelegate = self;
 unknowPersonVC.displayedPerson = aOldRecord;
 unknowPersonVC.allowsAddingToAddressBook = YES;
 unknowPersonVC.allowsActions = YES;

 [currentNavigationViewController pushViewController:unknowPersonVC animated:YES];

如何存取iPhone 通訊錄裡的資料

iPhone 內部是使用 SQLite3 作為通訊錄的資料庫，但是因為沙盒的限制(沙盒「sandbox」: 指程式在一個獨立且受限的虛擬環境裡執行，可確保不會受其它干擾，也不干擾其它程式運作) 。所以，你是無法直接讀取的必需透過 XCode 所提供的 AddressBook.framework 來讀取和寫入資料。

而 AddressBook.framework 所提的 API，比較接近 C 語言，無法直接使用 NSArray, NSString 來定義變數；其實，在學XCode以來，在 AddressBook.framework 所定義的變數保留字，一直給我一種“為定義而定義”的感覺，很多餘。但不列出來，再過一陣子，我一定會忘了；在此，先列出在 AddressBook.framework 中所使用的變數保留字。

• ABAddressBookRef : 用來宣告 AddressBook物件變數，AddressBook物件在使用上，和 NSManagedObjectContext 一樣，任何對 iPhone 通訊錄的讀取或儲存，都需要透過 AddressBook物件來完成；而建立一個 AddressBook物件指令為 ABAddressBookRef addressBookObj = ABAddressBookCreateWithOptions(NULL, NULL);
• ABRecordRef : 用來宣告 ABPerson 物件變數，一筆資料即為一 ABPerson 物件。例如： 產生一筆空白資料，指令為 ABRecordRef newPerson = ABPersonCreate();
• CFTypeRef : 萬用變數宣告，其實它就是 void* ；用於字串、任一數值， 例如： CFTypeRef firstName;
• CFArrayRef : 用來宣告陣列變數；

知道了 AddressBook.framework 常用的變數保留字，就來將 iPhone 通訊錄中的 所有記錄取出來吧～

 //產生 AddressBook 物件
 ABAddressBookRef addressBookObj = ABAddressBookCreateWithOptions(NULL, NULL); 
 //取出所有聯絡人記錄
 CFArrayRef allPeoples = ABAddressBookCopyArrayOfAllPeople(addressBookObj);
 int numPeople = CFArrayGetCount(allPeoples);
 //依續取出每個聯絡人資料
 for(int i=0 ; i<numPeople; i++ ) {
    ABRecordRef onePeople = numPeople[i];
    // 取出該聯絡人所有資訊
 }

有了聯絡人，接著就著手處理聯絡人所包含資訊。首先，資料有分單一資料(Property)和多項資料(MultiProperty)，取出後的處理方法也不一樣； 先釐清一個觀念，CFDictionary(屬性：kABDictionaryPropertyType)是單一資料，雖然，Dictionary 可以包含很多資料；而屬性 kABMultiDictionaryPropertyTyple 才是多項資料；很明顯地，在屬性鍵值有'multi’的字眼，便是多項資料； 取出資料的指令為

 CFTypeRef valueRef = ABRecordCopyValue(oenPeople, kABDictionaryPropertyType);

而要取出所有資料的方法如下：

 for(ABPropertyID propKey = kABPersonFirstNameProperty; propKey <= kABPersonSocialProfileProperty; propKey++) {
    //先取出數值
    CFTypeRef valueRef = ABRecordCopyValue(onePeople,propKey);

    ABPropertyType propType = ABPersonGetTypeOfProperty(propKey); 
    //判斷是單一資料或多項資料
    if(propType & kABMultiValueMask) {
        //多項資料處理
    } else {
        //單一資料處理
    }
 }

接著，讓我們看看在一筆聯絡人記錄中，帶有那些資訊吧～

ABPropertyID	描述
kABPersonFirstNameProperty;	First name - kABStringPropertyType
kABPersonLastNameProperty;	Last name - kABStringPropertyType
kABPersonMiddleNameProperty;	Middle name - kABStringPropertyType
kABPersonPrefixProperty;	Prefix ("Sir" "Duke" "General") - kABStringPropertyType
kABPersonSuffixProperty;	Suffix ("Jr." "Sr." "III") - kABStringPropertyType
kABPersonNicknameProperty;	Nickname - kABStringPropertyType
kABPersonFirstNamePhoneticProperty;	First name Phonetic - kABStringPropertyType
kABPersonLastNamePhoneticProperty;	Last name Phonetic - kABStringPropertyType
kABPersonMiddleNamePhoneticProperty;	Middle name Phonetic - kABStringPropertyType
kABPersonOrganizationProperty;	Company name - kABStringPropertyType
kABPersonJobTitleProperty;	Job Title - kABStringPropertyType
kABPersonDepartmentProperty;	Department name - kABStringPropertyType
kABPersonEmailProperty;	Email(s) - kABMultiStringPropertyType
kABPersonBirthdayProperty;	Birthday associated with this person - kABDateTimePropertyType
kABPersonNoteProperty;	Note - kABStringPropertyType
kABPersonCreationDateProperty;	Creation Date (when first saved) - kABDateTimePropertyType
kABPersonModificationDateProperty;	Last saved date - kABDateTimePropertyType
kABPersonAddressProperty;	Street address - kABMultiDictionaryPropertyType
kABPersonDateProperty;	Dates associated with this person - kABMultiDatePropertyType
kABPersonKindProperty;	Person/Organization - kABIntegerPropertyType
kABPersonPhoneProperty;	Generic phone number - kABMultiStringPropertyType
kABPersonInstantMessageProperty;	Instant Messaging - kABMultiDictionaryPropertyType
kABPersonURLProperty;	URL - kABMultiStringPropertyType
kABPersonRelatedNamesProperty;	Names - kABMultiStringPropertyType
kABPersonSocialProfileProperty	kABMultiDictionaryPropertyType

先來看看多項資料，要怎麼處理？

 CFTypeRef *multiValueRef = ABRecordCopyValue(onePeople,propKey);

 //先取得資料的數量
 int numberOfValues = ABMultiValueGetCount(multiValueRef);

 //在來依續取出其中的資料
 for(int i = 0 ; i<numberOfValues ; i++) {
    CFTypeRef *singleValureRef = ABMultiValueCopyLabelAtIndex(multiValueRef,i);
    //單一資料處理
 }

問題來了，取出來的數值型別皆為 CFTypeRef，若是很熟悉 CFType，那直接使用吧，但我就不熟，所以，還是要轉換成 XCode 常用的型別；

 NSString *stringValue = CFBridgingRelease(valueRef);   **//kABStringPropertyType**
 NSNumber *numberValue = CFBridgingRelease(valueRef);   **//kABIntegerPropertyType**
 NSDate *dateValue = CFBridgingRelease(valueRef);       **//kABDateTimePropertyType**
 NSDictionary *dictionaryValue = CFBridgingRelease(valueRef);   **//kABDictionaryPropertyType**

XCode "區塊運算"分享

Reference from: Blocks Programming Topics
在XCode的開發中，會看到 ^符號,它除了可以作為XOR運算外，在XCode還有一個很常用的操作，^可作為區塊運算的識別字。有關XCode 的區塊運算是一個非常方便的工具，它可以當作 callback function，也可以將一組function直接嵌入你要呼叫的function裡，例如：

//在沒有ARC下，可在ViewController 移除後，將自已給釋放
[myViewController dismissViewControllerAnimated:YES 
    completion:^() {
        [myViewController release];
        myViewController = nil;
    }
];

在官網文件中，開宗明義指出You use the ^ operator to declare a block variable and to indicate the beginning of a block literal. The body of the block itself is contained within {}。 '^'符號作為區塊(Block)的開頭文字，在使用方法上，請見下圖不解釋了。

除了官網文件中所提到的範例，另外我也列出一些我在使用上所使用例子：

• 當 callback function 使用

//MyViewController.h
typedef void (^TouchedInside)();

@interface MyViewController : UIView
{
    __strong TouchedInside  _insideBlock;
}
-(void)setTouchedInsideBlock:(TouchedInside)insideBlock;
@end
//MyViewController.m
@implementation FPTouchView
-(void)setTouchedInsideBlock:(TouchedInside)insideBlock
{
    _insideBlock = [insideBlock copy];
}

@end

• 把區塊(block)直接嵌入要呼叫函數裡

//Declare in UIViewController.h
- (void)dismissViewControllerAnimated: (BOOL)flag completion: (void (^)(void))completion;
//sample
[myViewController dismissViewControllerAnimated:YES 
    completion:^() {
        [myViewController release];
        myViewController = nil;
    }
];

iOS Development Program (IDP) 瞭解如何設定開發者環境

在註冊成為 Apple 開發者之後，接著便要著手設定環境開始開發 iOS App了；但很多初學者在還沒開始，便已經被如何設定開發環境，搞得昏頭轉向了。 以下便是我作的簡單的整理：

1.取得開發者認證 CA

一位合法的 iOS 開發者，要開發出可散佈的 App，首先要要先從 apple 取得合法的CA (所謂CA，即是Certificate Authority；電子憑證)。而 iOS 開發者認證CA有二種；“iOS Development” ﹠“iOS Distribution” ，就字面意思就是研發用和上架用（其實還有其它四種，這裡先不介紹）。iOS的認證採雙向認證；所以，要開發者自已先產生“憑證要求檔”，再用這個“認證授權檔”上傳至 Apple，來取得你專屬的認證(xxx.cer)。

1.1 建立“憑證要求檔”來向Apple 要求憑證：

先開啟程式“鑰匙圈存取”；在從程式選單選取“鑰匙圈存取“->“憑證輔助程式”->“從憑證授權要求憑證來開啟“憑證輔助程式”視窗。 

1.1.1 使用者電子郵件位址：請填入和開發者帳一致的Email Address.
1.1.2 一般名稱：你的英文名字 或 公司名稱.
1.1.3 已將要求：請選擇“儲存到磁碟”，並勾選取”指定密鑰配對資訊“

按選“繼續”，跳至“密鑰配對資訊”，其預設值為“2048 bit”﹠“RSA”，不用動；再來就一直按“續繼”，直到憑證要求檔建立為止。

當建立憑證要求檔後，在“鑰匙圈存取”的“鑰匙”類別，會產生二個鑰匙。

1.2 取得開發者憑證

1.2.1 上傳“憑證要求檔” 開啟網頁“http://developer.apple.com”，點取“iOS Dev Center”（此時可能會要求你登入，請登入），在右邊的快捷項目中，點取“Certificates, Identifiers & Profiles”；之後，點取"Certificates"，來設定開發者憑證。

1.2.2 產生憑證設定檔(Profile) 在“Certificates, Identifiesr & Profiles”頁面下，點取“Certificates”下的“All“。再點取右邉的加號方塊來產生憑證設定檔；當你按了”加號方塊“後，進入Profile 設定頁面。 這時，有個很重要的事，若從來沒有下載和安裝過WWDR憑證（WWDR？ 目前，所做的事都是為了取得私鑰，而WWDR就是公鑰啦！開發時需要同時要有公私鑰，請在“Profile設定頁面”的最下方，點連結 “Worldwide Developer Releations Certificate Authority”去下載。下載後，雙擊該檔，就會安裝至鑰匙圈了。

當安裝完Certificate後，在“鑰匙圈存取”的“憑證”類別，可以看到你所安裝的憑證。展開它，可看到它指向產生它的key。

總結上述的步驟；為了要取得開發所需要的電子憑證，要先自行產"憑證要求檔"，在產生憑證要求檔後，便會在鑰匙圈內產生專用密鑰；接著登入“Apple 開發者網站”，先取得WWDR公用憑證，依指示上傳“憑證要求檔”，以產生開發者憑證，以上；
但要注意要在發開過程沒有錯誤，這三個東西，一個都不能少；也就是WWDR，開發者憑證和產生憑證用的專用密鑰，全都要都在鑰匙圈內。
有關CA憑證就是這樣啦～ 但可以開發了嗎？答是 ...還早，開發還需Provisioning profiles

2.在“Certificates, Identifiers & Profiles” 頁面中

2.1 Certificates：

用來管理CA憑證的地方，先前就是產生CA的方法。

2.2 Identifiers：

建立和管理另 AppID 的地方, 每一個App都有一組全世界唯一的ID，就在這裡建立管理；除了AppID，另外的是給Passbook和推播用的 ID。

2.3 Device：

建立和管理測試用的iPhone和iPad。一個開發者帳號只能列100個裝備(device)。

2.4 Provisioning profile:

管理Provisioning profile：（它的性質很像是一組設定檔）是Certificate/ID/Devices的集合（注意，我在device 使用複數）。舉例：假設我要開發一個新的App，叫“HappyApp”， 而devices已經建立了我和客戶所有測試用的機器。於是，我先到App ID去建立一組HappyApp專屬的ID，再到Provisioning 建立一組新的開發用profile，在profile設定頁面中，選擇一個開發用CA憑證和”HappyApp”的AppID，再將要測試用的機器勾選起來，最後按建立，便可產生一個給”HappyApp”開發用的provisioning profile。
而要給”HappyApp”上架用的profile要另外建立（只需選上架用CA和這個”HappyApp”的ID即可)。最後，將這二個Profiles下載下來，放入XCode的Organizer(在啟起XCode程式，按shift+command+2，即可開啟Organizer)。新建HappyApp這個XCode專案時，要需要AppID一致，並在設定中分別選擇這二個Profiles給開發和上架用，即可

UITextField Usage

UITextField 若需要客製化功能，需要加入UITextFieldDelegate, 使用上：

1. 在 header 檔內，加入
2. 在interface builder入，將 UITextField的delegate拉到 File's owner; 若有時候 Controller一直收不到TextField的Event，就大可能是未設定TextField的Delegate;

而在UITextFieldDelegate 中，常用的函數列出如下：

- (BOOL)textFieldShouldBeginEditing:(UITextField *)textField;  
//若不允許被編輯，則return NO，  

- (void)textFieldDidBeginEditing:(UITextField *)textField;           
//目前物件成為focus 物件

- (BOOL)textFieldShouldEndEditing:(UITextField *)textField;          
//return YES， 允許結束編輯並重設focus物件的狀能
//return NO，不允許結束編輯`

- (void)textFieldDidEndEditing:(UITextField *)textField;
//??
//may be called if forced even if shouldEndEditing returns NO (e.g. view removed from window) or endEditing:YES called

- (BOOL)textField:(UITextField *)textField shouldChangeCharactersInRange:(NSRange)range replacementString:(NSString *)string;   
//return NO，不允許改變文字

- (BOOL)textFieldShouldClear:(UITextField *)textField;        
//當 User按 clear按鈕, 則此函數會被呼叫；return NO 去忽略 clear 命令

- (BOOL)textFieldShouldReturn:(UITextField *)textField;              
//當 User 按 "換行"鈕， 則此函數會被呼叫；return NO 去忽略 換行 命令

以下有我使用上幾個實例，

範例一

我希望當使用者， 點 TextField 時，能跳出一個對話框、執行一個動畫、或一個選單；這時候，我可以使用 UITextField Delegate

- (BOOL)textFieldShouldBeginEditing:(UITextField *)textField

進一步，我要 TextField 的內容，皆選單或程式完成，不要使用者直接輸入；這時候，我在這個函數的最後回傳“NO”，即可。有點像將 "User Interaction Disabled".

範例二

這是滿常見的，在將 TextField 的英文，轉換成大寫 (Upper case string)

- (IBAction)textFieldValueChanged:(id)sender {
    firstNameField.text = [firstNameField.text uppercaseString];
}

RN: 2013Oct2:新增 範例一﹠範例二

Apple 的設計真的是走回頭路嗎？

話說今年 WWDC 的開發者大會中， iOS 7.0 的扁平化的設計，當然是有批評的聲音，這些批評直指整個重新的設計沒有新意；讓我們聽聽設計師 evenwu 看出那些內涵了。