開始使用

Android

• 使用 Android Studio 3.2 以上版本
• 請確認應用程式的建構檔案使用下列值：
  • minSdkVersion 16 以上
  • compileSdkVersion 為 28 以上

iOS

• 使用 Xcode 13 以上版本
• 指定 iOS 10.0 以上版本

Android

我們建議您使用 CMake，但您也可以在我們的一般 Firebase C++ SDK 入門指南中找到 ndk-build 的操作說明，將 libfirebase_app.a 和 libfirebase_gma.a 連結至應用程式。

1. 在專案的 gradle.properties 檔案中，指定未解壓縮的 SDK 位置：

   systemProp.firebase_cpp_sdk.dir=FULL_PATH_TO_SDK
   

2. 在專案的 settings.gradle 檔案中新增以下內容：

   def firebase_cpp_sdk_dir = System.getProperty('firebase_cpp_sdk.dir')
   
   gradle.ext.firebase_cpp_sdk_dir = "$firebase_cpp_sdk_dir"
   includeBuild "$firebase_cpp_sdk_dir"
   

3. 在模組 (應用程式層級) Gradle 檔案 (通常為 app/build.gradle) 中，加入下列內容，其中包含 Google Mobile Ads C++ SDK 的程式庫依附元件。

   android.defaultConfig.externalNativeBuild.cmake {
     arguments "-DFIREBASE_CPP_SDK_DIR=$gradle.firebase_cpp_sdk_dir"
   }
   
   # Add the dependency for the Google Mobile Ads C++ SDK
   apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle"
   firebaseCpp.dependencies {
     gma
   }
   

4. 在專案的 CMakeLists.txt 檔案中加入以下內容。

   # Add Firebase libraries to the target using the function from the SDK.
   add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL)
   
   # Add the Google Mobile Ads C++ SDK.
   
   # The Firebase C++ library `firebase_app` is required,
   # and it must always be listed last.
   
   set(firebase_libs
     firebase_gma
     firebase_app
   )
   
   target_link_libraries(${target_name} "${firebase_libs}")
   

5. 同步處理應用程式，確保所有依附元件皆為必要的版本。

iOS

本節的步驟示範如何將 Google Mobile Ads C++ SDK 新增至 iOS 專案。

1. 如要取得 CocoaPods 1 以上版本，請執行以下指令：

   sudo gem install cocoapods --pre
   

2. 從解壓縮的 SDK 中加入 Google Mobile Ads Pod。

   1. 如果你沒有 Podfile，請先建立 Podfile：

      cd APP_DIRECTORY
      pod init
      

   2. 請在 Podfile 中加入 Google Mobile Ads C++ SDK、Google User Messaging Platform SDK 和最小 Firebase 核心 SDK 的 Pod (由 GMA C++ SDK 所需)：

      pod 'Firebase/CoreOnly'
      pod 'Google-Mobile-Ads-SDK'
      pod 'GoogleUserMessagingPlatform'
      

   3. 安裝 Pod，然後在 Xcode 中開啟 .xcworkspace 檔案。

      pod install
      open APP.xcworkspace
      

   4. 將 Firebase C++ SDK 中的下列架構新增至專案：

      • xcframeworks/firebase.xcframework
      • xcframeworks/firebase_gma.xcframework

Android

請按照 Mobile Ads SDK Android 指南所述的「設定應用程式」步驟 3 操作，然後返回本頁。

iOS

請按照更新 Info.plist 步驟操作，詳情請參閱 Mobile Ads SDK iOS 指南，然後返回本頁。

Android

// Initialize the Google Mobile Ads library
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(jni_env, j_activity, &result);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing
  // dependency. Check the device logs for more information.
  return;
}

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}

iOS

// Initialize the Google Mobile Ads library.
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(&result);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing
  // dependency. Check the device logs for more information.
  return;
}

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}