開始使用

Android

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

iOS

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

Android

建議使用 CMake，但您可在我們的 一般 Firebase C++ SDK 入門指南 指南 將 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 行動廣告 C++ SDK 新增至 iOS 專案。

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

   sudo gem install cocoapods --pre
   

2. 從解壓縮的 SDK 加入 Google Mobile Ads 廣告連播。

   1. 如果您尚未建立 Podfile，請建立一個：

      cd APP_DIRECTORY
      pod init
      

   2. 請在 Podfile 中新增 Google Mobile Ads C++ SDK 的 Pod， Google User Messaging Platform SDK，以及最簡單的 Firebase 核心 SDK (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

按照設定應用程式步驟 3 的指示，按照 Mobile Ads SDK 的說明 Android 指南 再回到這個頁面

iOS

按照 Mobile Ads SDK 的說明進行更新 Info.plist 步驟 再回來查看 。

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.
}