开始使用

Android

• 使用 Android Studio 3.2 或更高版本
• 确保应用的 build 文件使用以下值：
  • 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 - 添加以下内容，其中包括 库依赖项。

   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 移动广告广告连播。

   1. 如果您没有 Podfile，请创建一个：

      cd APP_DIRECTORY
      pod init
      

   2. 在 Podfile 中，将 Google 移动广告 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

按照移动广告 SDK 的说明配置应用中的第 3 步操作 Android 指南 然后再返回到此页面

iOS

按照移动广告 SDK 中的说明，执行更新您的 Info.plist 操作。 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.
}