XPUSH.MOBI!!HƯỚNG DẪN TÍCH HỢP PUSH NOTIFICATION CHO IOS!

!

!I. Mục đích!!Tài liệu này hướng dẫn Developer tích hợp Dịch vụ PushNotify cho iOS, cung cấp bởi dịch vụ xPush.!Dịch vụ được cung cấp trọn gói gồm: thư viện cho nhà phát triển, chức năng test thử nghiệm Online (sắp ra mắt), chức năng gửi PushNotify cho toàn bộ các cài đặt của ứng dụng (production).!Dịch vụ xPush được cung cấp MIỄN PHÍ cho nhà phát triển và các ứng dụng trong chế độ community.!Tải thư viện cho iOS tại: https://dl.dropboxusercontent.com/u/18787546/XMPushLibrary.framework.zip!!II. Chi tiết!! 1.! Thừa kế AppDelegate từ XMAPP và thực hiện 1 protocol! @interface AppDelegate : XMApp<PushServerDataSource>!

Trong file AppDelegate của ứng dụng, thừa kế ứng dụng của bạn với lớp cha là XMApp, trường hợp mặc định bạn sẽ không cần thực thi phương thức của PushServerDataSource.!

!#import <XMPushLibrary/XMPushLibrary.h>!

@interface AppDelegate : XMApp<PushServerDataSource>!

! 2.! đăng ký dịch vụ xPush! Bạn thêm trong phần Build Settings của Xcode, mục Preprocessor 1 cờ định hướng là SANDBOX=1!

!- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{ !     //sau khi đã thừa kế Delegate từ lớp cha XMApp

//Push registration!

NSMutableDictionary* myLaunchOption = [NSMutableDictionary dictionaryWithDictionary: launchOptions] ; //sandbox only!

! #if (SANDBOX == 1)!

[myLaunchOption setValue:TOKEN_SANDBOX forKey:TOKEN_MODE];!#else! [myLaunchOption setValue:TOKEN_PRODUCTION forKey:TOKEN_MODE];!#endif!

! [super application:application

didFinishLaunchingWithOptions:myLaunchOption];!

//Push registration end.!

! !     return YES; }!

Chú ý: với các ứng dụng được cài đặt từ Xcode, các token là dành cho sandbox. Để tránh gây nhầm lẫn không đáng có, chúng tôi khuyến nghị dùng dòng 1,2. Khi build ứng dụng sẵn sàng để phân phối (ví dụ: đẩy lên Apple Store), bạn chỉ cần thay chỉ dẫn SANDBOX=0 trong phần preprocessor của Xcode/Build Settings.!

!!3. Thực thi các phương thức liên quan đến Push

Bộ tham số username, password được cung cấp sau khi bạn đăng ký sử dụng dịch vụ (ở cả chế độ Community và Enterprise)#pragma mark PushServerDataSource -(NSString*) getUsername{

    return @"<username>";}-(NSString*) getPassword{    return @"<password>";}!

Chú ý: ở phiên bản hiên tại, bộ tham số user/password chưa cần được sử dụng. Bạn không cần thực hiện DataSource này.!4. Link với framework do xPush cung cấp!

Để tải framework, truy cập http://xpush.mobi hoặc https://dl.dropboxusercontent.com/u/18787546/XMPushLibrary.framework.zip!

!Ngoài ra, ASINetworking (https://dl.dropboxusercontent.com/u/18787546/

ASINetworking.framework.zip)!và SSZipArchive (https://dl.dropboxusercontent.com/u/18787546/

ssziparchive.zip) cũng cần được khai báo trong danh sách thư viện cho linker.!

III. Push thông tin đến ứng dụng đã cài đặt từ AppleStore!

!Chú ý: Bạn sẽ các khoá private tương ứng với Certificate tạo trên Developer

portal của Apple. Để tạo được chữ ký, bạn cần phải đăng ký và thanh toán phí thường niên 99$ cho Apple.!

Có hai loại chữ ký cho chế độ thử nghiệm (Sandbox) và Phân phối (production).!!

Để gửi tin Push cho ứng dụng ở chế độ thử nghiệm, bạn sẽ cần chữ ký Sandbox. Với các ứng dụng được download từ AppleStore, bạn có thể push thông qua xpush.mobi sau bằng chữ ký Production, sau khi đăng ký là người dùng Community hoặc Enterprise.!

Chú ý: Apple không giữ các khoá private, các khoá này được tạo từ máy đã yêu cầu tạo Certificate, bạn có thể chạy KeyChain để export các khoá private và chỉ private này.!Chú ý: mỗi certificate (push sandbox/production) cần được khởi tạo bởi 1 file .certSigningRequest khác nhau để đảm bảo không bị trùng khoá.!!Bạn có thể gửi tin Push từ trang web xpush.mobi hoặc từ ứng dụng

PushNotification cài trên PC/WIndows.!!Hướng dẫn dưới đây dành cho ứng dụng XPushNotification trên PC:!!Tải về bộ cài xPushNotification cho PC tại: https://dl.dropboxusercontent.com/u/18787546/installer.rar!!

!Nhập mã ứng dụng (appid/bundleid) của bạn, ví dụ: com.xmobilevn.camnangdienmay!Nhập nội dung tin sẽ gửi cho ipad/iphone trong phần Message.!Chọn số badge sẽ hiển thị trên icon của ứng dụng (trong trường hợp ứng dụng đang được kích hoạt trên iOS sẵn)!Để có thể gửi tin nhắn đến toàn bộ các khách hàng ở chế độ Production, bạn cần phải nhập mật khẩu file Certificate và chọn file đó. Ứng dụng sẽ căn cứ vào mật khẩu để kiểm tra tính phù hợp của file với các thông tin đã nhập ở trên, ví dụ: mã ứng dụng, ngày tháng hợp lệ …!!!!!!!!!!!!!

!!Để gửi tin đến toàn bộ các ứng dụng đã cài từ Apple Store (chế độ production), chọn nút !PushNotification ở bên dưới và xác nhận.!!!!!!!!!!!!!!!!!!!

!Trường hợp bạn chỉ muốn gửi đến duy nhất 1 người dùng, hãy chọn Single Device, ô nhập liệu sẽ xuất hiện để bạn nhập device_token của thiết bị.!Thường trường hợp này ít khi sử dụng vì không thể nhận biết được device-token của từng device khi Ứng dụng đã lên store.!Tuy nhiên, cơ chế này rất phù hợp với việc test cho chế độ Sandbox ở bên dưới.!!!!!!!!!!!!!!!!

!!!IV. Push thông tin cho ứng dụng đang phát triển (cài

đặt bằng Xcode)!!!!!Giả sử bạn là 1 Developer, chế độ gửi Sandbox được phát triển dành tặng bạn.!!Hãy tải thư viện cho iOS tại: và làm theo hướng dẫn tại mục II.!

Tương tự bước III, bạn nhập mật khẩu và chọn file chữ ký cho dịch vụ Push chế độ sandbox và gửi bằng cách chọn Push Notification.!

!!!!IV. Phụ lục : cách tạo certificate trên Apple Developer !!Làm theo hướng dẫn tại developer.apple.com!