Bắt đầu nhanh trên iOS

Objective-C Swift

Các bước được mô tả trên trang này giải thích cách nhanh chóng tạo một ứng dụng iOS đơn giản đưa ra yêu cầu đối với YouTube Data API. Mẫu này cho biết cách truy xuất dữ liệu về kênh YouTube GoogleDevelopers. Mã này cũng bao gồm các nhận xét giải thích cách sửa đổi truy vấn để truy xuất dữ liệu về kênh YouTube của người dùng hiện tại.

Lưu ý: Ứng dụng này không tuân thủ Nguyên tắc về giao diện người dùng của Apple dành cho iOS. Ứng dụng này chỉ nhằm minh hoạ các khái niệm và bước cơ bản cần thiết để bắt đầu sử dụng YouTube Data API.

Điều kiện tiên quyết

Để chạy hướng dẫn bắt đầu nhanh này, bạn cần có:

• Xcode 8.0 trở lên.
• CocoaPods trình quản lý phần phụ thuộc.
• Quyền truy cập vào Internet và trình duyệt web.
• Tài khoản Google.

Bước 1: Bật YouTube Data API

1. Sử dụng trình hướng dẫn này để tạo hoặc chọn một dự án trong Google Developers Console và tự động bật API. Nhấp vào Tiếp tục, sau đó Chuyển đến thông tin xác thực.

2. Trên trang Tạo thông tin xác thực, hãy nhấp vào nút Huỷ.

3. Ở đầu trang, hãy chọn thẻ Màn hình xin chấp thuận OAuth. Chọn một Địa chỉ email, nhập Tên sản phẩm (nếu chưa đặt) rồi nhấp vào nút Lưu.

4. Chọn thẻ Thông tin xác thực, nhấp vào nút Tạo thông tin xác thực rồi chọn Mã ứng dụng khách OAuth.

5. Chọn loại ứng dụng iOS, nhập tên "YouTube Data API Quickstart", mã nhận dạng gói com.example.QuickstartApp rồi nhấp vào nút Create button.

Bước 2: Chuẩn bị không gian làm việc

Lưu ý: Tất cả ví dụ đều dựa trên tên com.example.QuickstartApp. Nếu bạn đặt tên cho ứng dụng của mình khác với tên đó, chẳng hạn như com.example.QuickstartYTApp, hãy thay đổi chuỗi QuickstartApp cho phù hợp với tên ứng dụng của bạn.

1. Mở Xcode rồi tạo một dự án mới:
   1. Nhấp vào File > New > Project (Tệp > Mới > Dự án), chọn mẫu iOS > Application > Single View Application (iOS > Ứng dụng > Ứng dụng chế độ xem đơn) rồi nhấp vào Next (Tiếp theo).
   2. Đặt Product Name (Tên sản phẩm) thành "QuickstartApp", Organization Identifier (Mã nhận dạng tổ chức) thành "com.example" và Language (Ngôn ngữ) thành Objective-C. Bên dưới mã nhận dạng tổ chức, bạn sẽ thấy một Bundle Identifier (Mã nhận dạng gói) được tạo khớp với iOS Bundle ID (Mã nhận dạng gói iOS) (com.example.QuickstartApp) mà bạn đã nhập ở bước 1.b.
   3. Nhấp vào Next (Tiếp theo).
   4. Chọn một thư mục đích cho dự án rồi nhấp vào Create (Tạo).
2. Đóng dự án bằng cách nhấp vào File > Close Project (Tệp > Đóng dự án).
3. Mở cửa sổ dòng lệnh rồi chuyển đến thư mục chứa tệp QuickstartApp.xcodeproj mà bạn vừa tạo.

4. Chạy các lệnh sau để tạo Podfile, cài đặt thư viện và mở dự án XCode kết quả:

   cat << EOF > Podfile &&
   platform :ios, '8.0'
   target 'QuickstartApp' do
       pod 'GoogleAPIClientForREST/YouTube', '~> 1.2.1'
       pod 'Google/SignIn', '~> 3.0.3'
   end
   EOF
   pod install &&
   open QuickstartApp.xcworkspace
   

5. Trong XCode Project Navigator (Trình điều hướng dự án XCode), hãy chọn nút dự án "QuickstartApp". Sau đó, hãy nhấp vào mục trình đơn File > Add files to "QuickstartApp" (Tệp > Thêm tệp vào "QuickstartApp").

   

6. Tìm tệp GoogleService-Info.plist đã tải xuống trước đó rồi chọn tệp đó. Nhấp vào nút Options (Tuỳ chọn).

   

7. Chọn các mục sau trong cửa sổ tuỳ chọn rồi nhấp vào nút Add (Thêm):

   1. Đánh dấu vào hộp Copy items if needed (Sao chép các mục nếu cần).
   2. Đánh dấu vào tất cả mục tiêu được liệt kê trong phần Add to targets (Thêm vào mục tiêu).

   

8. Khi nút dự án vẫn được chọn, hãy chọn "QuickstartApp" trong phần TARGETS (MỤC TIÊU) như trong 2 hình bên dưới:

   1. Nhấp vào khu vực được minh hoạ trong ảnh chụp màn hình này:

   2. Sau đó, hãy chọn mục tiêu thích hợp:

9. Chọn thẻ Info (Thông tin) rồi mở rộng phần URL Types (Loại URL).

10. Nhấp vào nút + rồi thêm URL scheme (Lược đồ URL) cho mã ứng dụng khách đảo ngược. Để tìm giá trị này, hãy mở tệp cấu hình GoogleService-Info.plist mà bạn đã chọn ở bước 2.f. Tìm khoá REVERSED_CLIENT_ID. Sao chép giá trị của khoá đó rồi dán vào hộp URL Schemes (Lược đồ URL) trên trang cấu hình. Để trống các trường khác.

11. Tạo lại dự án:

    1. Nhấp vào Product > Clean Build Folder (trong khi giữ phím option ).
    2. Nhấp vào Product > Build (Sản phẩm > Bản dựng).

Bước 3: Thiết lập mẫu

Thay thế nội dung của các tệp sau bằng mã được cung cấp:

AppDelegate.h

#import <UIKit/UIKit.h>
@import GoogleSignIn;

@interface AppDelegate : UIResponder <UIApplicationDelegate>

@property (strong, nonatomic) UIWindow *window;


@end

AppDelegate.m

#import "AppDelegate.h"

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Initialize Google sign-in.
    [GIDSignIn sharedInstance].clientID = @"<YOUR_CLIENT_ID>";

    return YES;
}

- (BOOL)application:(UIApplication *)application
            openURL:(NSURL *)url
  sourceApplication:(NSString *)sourceApplication
         annotation:(id)annotation {
    return [[GIDSignIn sharedInstance] handleURL:url
                               sourceApplication:sourceApplication
                                      annotation:annotation];
}


@end

ViewController.h

#import <UIKit/UIKit.h>
@import GoogleSignIn;
#import <GTLRYouTube.h>

@interface ViewController : UIViewController <GIDSignInDelegate, GIDSignInUIDelegate>

@property (nonatomic, strong) IBOutlet GIDSignInButton *signInButton;
@property (nonatomic, strong) UITextView *output;
@property (nonatomic, strong) GTLRYouTubeService *service;


@end

ViewController.m

#import "ViewController.h"

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    // Configure Google Sign-in.
    GIDSignIn* signIn = [GIDSignIn sharedInstance];
    signIn.delegate = self;
    signIn.uiDelegate = self;
    signIn.scopes = [NSArray arrayWithObjects:kGTLRAuthScopeYouTubeReadonly, nil];
    [signIn signInSilently];

    // Add the sign-in button.
    self.signInButton = [[GIDSignInButton alloc] init];
    [self.view addSubview:self.signInButton];

    // Create a UITextView to display output.
    self.output = [[UITextView alloc] initWithFrame:self.view.bounds];
    self.output.editable = false;
    self.output.contentInset = UIEdgeInsetsMake(20.0, 0.0, 20.0, 0.0);
    self.output.autoresizingMask = UIViewAutoresizingFlexibleHeight | UIViewAutoresizingFlexibleWidth;
    self.output.hidden = true;
    [self.view addSubview:self.output];

    // Initialize the service object.
    self.service = [[GTLRYouTubeService alloc] init];
}

- (void)signIn:(GIDSignIn *)signIn
didSignInForUser:(GIDGoogleUser *)user
     withError:(NSError *)error {
    if (error != nil) {
        [self showAlert:@"Authentication Error" message:error.localizedDescription];
        self.service.authorizer = nil;
    } else {
        self.signInButton.hidden = true;
        self.output.hidden = false;
        self.service.authorizer = user.authentication.fetcherAuthorizer;
        [self fetchChannelResource];
    }
}


// Construct a query and retrieve the channel resource for the GoogleDevelopers
// YouTube channel. Display the channel title, description, and view count.
- (void)fetchChannelResource {
    GTLRYouTubeQuery_ChannelsList *query =
    [GTLRYouTubeQuery_ChannelsList queryWithPart:@"snippet,statistics"];
  query.identifier = @"UC_x5XG1OV2P6uZZ5FSM9Ttw";
  // To retrieve data for the current user's channel, comment out the previous
  // line (query.identifier ...) and uncomment the next line (query.mine ...).
  // query.mine = true;

  [self.service executeQuery:query
                    delegate:self
           didFinishSelector:@selector(displayResultWithTicket:finishedWithObject:error:)];
}

// Process the response and display output
- (void)displayResultWithTicket:(GTLRServiceTicket *)ticket
             finishedWithObject:(GTLRYouTube_ChannelListResponse *)channels
                          error:(NSError *)error {
  if (error == nil) {
    NSMutableString *output = [[NSMutableString alloc] init];
    if (channels.items.count > 0) {
      [output appendString:@"Channel information:\n"];
      for (GTLRYouTube_Channel *channel in channels) {
        NSString *title = channel.snippet.title;
        NSString *description = channel.snippet.description;
        NSNumber *viewCount = channel.statistics.viewCount;
        [output appendFormat:@"Title: %@\nDescription: %@\nViewCount: %@\n", title, description, viewCount];
      }
    } else {
      [output appendString:@"Channel not found."];
    }
    self.output.text = output;
  } else {
    [self showAlert:@"Error" message:error.localizedDescription];
  }
}


// Helper for showing an alert
- (void)showAlert:(NSString *)title message:(NSString *)message {
    UIAlertController *alert =
    [UIAlertController alertControllerWithTitle:title
                                        message:message
                                 preferredStyle:UIAlertControllerStyleAlert];
    UIAlertAction *ok =
    [UIAlertAction actionWithTitle:@"OK"
                             style:UIAlertActionStyleDefault
                           handler:^(UIAlertAction * action)
     {
         [alert dismissViewControllerAnimated:YES completion:nil];
     }];
    [alert addAction:ok];
    [self presentViewController:alert animated:YES completion:nil];
}


@end

Bước 4: Chạy mẫu

Chuyển sang lược đồ QuickstartApp bằng cách nhấp vào Product > Scheme > QuickstartApp (Sản phẩm > Lược đồ > QuickstartApp) rồi chạy mẫu (Cmd+R) bằng trình mô phỏng thiết bị hoặc thiết bị đã định cấu hình. Trong lần đầu tiên chạy mẫu, hệ thống sẽ nhắc bạn đăng nhập vào tài khoản Google và cho phép truy cập.

Thực sự hiệu quả!

Tuyệt vời! Hãy xem phần tài liệu đọc thêm bên dưới để tìm hiểu thêm.

Tôi gặp lỗi

Tiếc quá. Cảm ơn bạn đã cho chúng tôi biết và chúng tôi sẽ tìm cách khắc phục hướng dẫn bắt đầu nhanh này.

Ghi chú

• Thông tin uỷ quyền được lưu trữ trong Chuỗi khoá, vì vậy, các lần thực thi tiếp theo sẽ không nhắc bạn uỷ quyền.

Tài liệu đọc thêm

• Tài liệu trợ giúp về Google Developers Console
• Tài liệu về ứng dụng API của Google cho iOS
• Tài liệu tham khảo về YouTube Data API