Thêm căn cứ hỏa lực cho dự án iOS của bạn

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

• Cài đặt như sau:

  • Xcode 10.3 hoặc mới hơn
  • CocoaPods 1.4.0 hoặc mới hơn

• Hãy chắc chắn rằng dự án của bạn đáp ứng được các yêu cầu:

  • Dự án của bạn phải nhắm mục tiêu iOS 8 hoặc cao hơn.

• Thiết lập một thiết bị iOS vật lý hoặc sử dụng các mô phỏng iOS chạy ứng dụng của bạn.

  Bạn có muốn sử dụng Cloud Messaging?

  Đối với Cloud Messaging trên iOS, đây là điều kiện tiên quyết:

  • Thiết lập một thiết bị iOS của vật lý.
  • Lấy một Apple Push Notification Xác thực chủ chốt cho bạn tài khoản nhà phát triển của Apple .
  • Bật thông báo đẩy trong XCode dưới App> Capabilities.

• Đăng nhập vào căn cứ hỏa lực sử dụng tài khoản Google của bạn.

Nếu bạn chưa có một dự án Xcode và chỉ muốn thử ra một sản phẩm căn cứ hỏa lực, bạn có thể tải về một trong chúng tôi mẫu QuickStart .

Bước 1: Tạo một dự án căn cứ hỏa lực

Trước khi bạn có thể thêm căn cứ hỏa lực để ứng dụng iOS của bạn, bạn cần phải tạo một dự án căn cứ hỏa lực để kết nối với ứng dụng iOS của bạn. Thăm Hiểu căn cứ hỏa lực dự án để tìm hiểu thêm về các dự án căn cứ hỏa lực.

Bước 2: Đăng ký ứng dụng của bạn với căn cứ hỏa lực

Sau khi bạn có một dự án căn cứ hỏa lực, bạn có thể thêm ứng dụng iOS của bạn với nó.

Thăm Hiểu dự án căn cứ hỏa lực để tìm hiểu thêm về thực tiễn tốt nhất và cân nhắc để thêm các ứng dụng cho một dự án căn cứ hỏa lực, bao gồm cách xử lý nhiều build biến thể.

1. Tới các căn cứ hỏa lực console .

2. Ở trung tâm của trang tổng quan về dự án, nhấp vào biểu tượng iOS ( plat_ios ) để khởi động công việc cài đặt.

   Nếu bạn đã thêm vào một ứng dụng cho dự án căn cứ hỏa lực của bạn, nhấp vào Thêm ứng dụng để hiển thị các tùy chọn nền tảng.

3. Nhập của ứng dụng của bạn ID bó trong iOS bó trường ID.

   ID bó là gì, và nơi nào bạn tìm thấy nó?

   • Một bó ID nhận dạng duy nhất một ứng dụng trong hệ sinh thái của Apple.

   • Tìm ID bó của bạn: mở iOS của bạn dự án trong Xcode, chọn ứng dụng cấp cao nhất trong các hoa tiêu dự án, sau đó chọn tab General.

     Giá trị của lĩnh vực Bundle Số nhận dạng bị iOS bó ID (ví dụ, com.yourcompany.yourproject ).

   • Hãy nhận biết rằng giá trị ID bó là trường hợp nhạy cảm, và nó không thể được thay đổi cho ứng dụng căn cứ hỏa lực iOS này sau khi nó được đăng ký với dự án căn cứ hỏa lực của bạn.

4. (Tùy chọn) Nhập thông tin ứng dụng khác: App nickname và App Store ID.

   Làm thế nào là những nickname App và App Store ID được sử dụng trong căn cứ hỏa lực?

   • App nickname: An, nhận dạng tiện nội bộ mà là chỉ hiển thị cho bạn trong căn cứ hỏa lực console

   • App Store ID: Được sử dụng bởi căn cứ hỏa lực động Liên kết để chuyển hướng người dùng đến trang App Store của bạn và Google Analytics để sự kiện chuyển đổi nhập vào Google Ads . Nếu ứng dụng của bạn vẫn chưa có một App Store ID, bạn có thể thêm các ID sau này trong bạn thiết lập dự án .

5. Bấm vào Đăng ký ứng dụng.

Bước 3: Thêm một tập tin cấu hình căn cứ hỏa lực

1. Nhấp vào Tải xuống GoogleService-Info.plist để có được tập tin cấu hình căn cứ hỏa lực iOS của bạn ( GoogleService-Info.plist ).

   Những gì bạn cần biết về tập tin cấu hình này?

   • Các tập tin cấu hình căn cứ hỏa lực chứa định danh duy nhất, nhưng không phải là bí mật đối với dự án của bạn. Để tìm hiểu thêm về tập tin cấu hình này, hãy truy cập Hiểu dự án căn cứ hỏa lực .

   • Bạn có thể tải về của bạn tập tin cấu hình căn cứ hỏa lực lại bất cứ lúc nào.

   • Hãy chắc chắn rằng tên tập tin cấu hình không được gắn với các nhân vật bổ sung, như (2) .

2. Di chuyển tập tin cấu hình của bạn vào thư mục gốc của dự án Xcode của bạn. Nếu được nhắc, chọn để thêm các tập tin cấu hình cho tất cả các mục tiêu.

Nếu bạn có nhiều bó ID trong dự án của bạn, bạn phải kết hợp mỗi bó ID với một ứng dụng đã đăng ký trong các căn cứ hỏa lực console để mỗi ứng dụng có thể có của riêng mình GoogleService-Info.plist tập tin.

Bước 4: Thêm căn cứ hỏa lực SDK để ứng dụng của bạn

Chúng tôi khuyên bạn sử dụng CocoaPods để cài đặt các thư viện căn cứ hỏa lực. Tuy nhiên, nếu bạn không muốn sử dụng CocoaPods, bạn có thể tích hợp các khuôn khổ SDK trực tiếp .

Bạn đang sử dụng một trong những mẫu QuickStart ? Dự án Xcode và Podfile (với vỏ) đã xuất hiện, nhưng bạn vẫn sẽ cần phải thêm tập tin cấu hình căn cứ hỏa lực của bạn và cài đặt các cụm.

1. Tạo một Podfile nếu bạn chưa có:

   cd your-project-directory 

   pod init

2. Để Podfile bạn, hãy thêm cụm căn cứ hỏa lực mà bạn muốn sử dụng trong ứng dụng của bạn.

   Bạn có thể thêm bất kỳ sản phẩm căn cứ hỏa lực hỗ trợ để ứng dụng iOS của bạn.

   kích hoạt Analytics

   # Add the Firebase pod for Google Analytics
   pod 'Firebase/Analytics'
   
   # Add the pods for any other Firebase products you want to use in your app
   # For example, to use Firebase Authentication and Cloud Firestore
   pod 'Firebase/Auth'
   pod 'Firebase/Firestore'

   Analytics không được kích hoạt

   # Add the pods for the Firebase products you want to use in your app
   # For example, to use Firebase Authentication and Cloud Firestore
   pod 'Firebase/Auth'
   pod 'Firebase/Firestore'

3. Cài đặt vỏ, sau đó mở của bạn .xcworkspace tập tin để xem dự án trong Xcode:

   pod install

   open your-project .xcworkspace

Bước 5: Khởi tạo căn cứ hỏa lực trong ứng dụng của bạn

Bước cuối cùng là thêm mã khởi tạo để ứng dụng của bạn. Bạn có thể đã làm điều này như là một phần của việc thêm căn cứ hỏa lực để ứng dụng của bạn. Nếu bạn đang sử dụng một dự án mẫu QuickStart , điều này đã được thực hiện cho bạn.

1. Nhập module căn cứ hỏa lực trong bạn UIApplicationDelegate :

   Nhanh

   import Firebase

   Objective-C

   @import Firebase;

2. Cấu hình một FirebaseApp chia sẻ Ví dụ, điển hình là trong ứng dụng của bạn application:didFinishLaunchingWithOptions: phương pháp:

   Nhanh

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. Nếu bạn đã bao gồm căn cứ hỏa lực Analytics, bạn có thể chạy ứng dụng của bạn để gửi xác minh để giao diện điều khiển căn cứ hỏa lực mà bạn đã cài đặt thành công căn cứ hỏa lực.

Đó là nó! Bạn có thể bỏ qua cho các bước tiếp theo .

vỏ sẵn

Phần này liệt kê các sản phẩm căn cứ hỏa lực hỗ trợ cho iOS và vỏ của họ. Tìm hiểu thêm về các thư viện căn cứ hỏa lực iOS:

• Tài liệu tham khảo ( Swift | obj-C )

• Căn cứ hỏa lực iOS SDK GitHub repo

chấp nhận:

Tích hợp mà không CocoaPods

Nếu bạn không muốn sử dụng Cocoapods, bạn vẫn có thể tận dụng lợi thế của SDK căn cứ hỏa lực bằng cách nhập các khuôn khổ trực tiếp.

Ngoài việc hỗ trợ các nền tảng iOS, zip hiện nay bao gồm các file .xcframework rằng sự ủng hộ Catalyst add dựa vào cộng đồng. Để biết chi tiết, xem các căn cứ hỏa lực iOS SDK README trên GitHub .

1. Tải zip framework SDK . Đây là một tập tin ~ 200MB và có thể mất một thời gian để tải về.

2. Giải nén tập tin, sau đó xem lại README cho Khung mà bạn muốn bao gồm trong ứng dụng của bạn.

3. Thêm ObjC mối liên kết cờ trong của bạn Other Linker Settings trong cài đặt xây dựng của đối tượng.

Bước tiếp theo

Tìm hiểu về căn cứ hỏa lực:

• Thăm Hiểu căn cứ hỏa lực dự án để tìm hiểu thêm về các dự án căn cứ hỏa lực và thực hành tốt nhất cho các dự án.

• Khám phá các ứng dụng căn cứ hỏa lực mẫu .

• Nhận kinh nghiệm thực tiễn với các căn cứ hỏa lực iOS Codelab .

• Khám phá những mã nguồn mở trong GitHub .

• Chuẩn bị để khởi động ứng dụng của bạn:

  • Thiết lập cảnh báo ngân sách cho dự án của bạn trong GCP console.
  • Màn hình của bạn Cách sử dụng và bảng điều khiển thanh toán trong căn cứ hỏa lực console.
  • Xem lại ra mắt danh sách kiểm tra căn cứ hỏa lực .

Thêm dịch vụ căn cứ hỏa lực để ứng dụng của bạn:

• Đạt được những hiểu biết về hành vi người dùng với Analytics .

• Thiết lập xác thực người dùng với xác thực .

• Lưu trữ dữ liệu, như thông tin người dùng, với Mây FireStore hoặc cơ sở dữ liệu thời gian thực .

• Lưu trữ tệp, giống như hình ảnh và video, với Cloud Storage .

• Kích hoạt backend mã mà chạy trong một môi trường an toàn với Mây Chức năng .

• Gửi thông báo với Cloud Messaging .

• Tìm hiểu khi nào và tại sao ứng dụng của bạn bị lỗi với Crashlytics .