一:前提条件
1.运行 Eclipse 3.7.2 (Indigo) 或更高版本2.Eclipse JDT 插件(大多数 Eclipse IDE 程序包中都提供)3.适用于 Eclipse 的 Android 插件4.Android SDK二:创建新项目在此步骤中,我们将在 Eclipse 中创建一个全新的项目,以在我们的快速入门教程中使用。打开 Eclipse,系统将显示空白工作区,请从菜单中选择“File”(文件)>“New”(新建)>“Project...”(项目...)。选择 Android 文件夹,然后选择 Android Application Project(Android 应用项目)并点击“Next”(下一步)。输入“BannerExample”作为应用和项目名称,并输入您通常使用的程序包名称。接下来,为项目指定必需的最低 SDK 版本 9。该版本是 Google 移动广告 SDK 支持的最低版本。为了让此快速入门教程简单易懂,我们取消选中“Create custom launcher icon”(创建自定义启动器图标)复选框。其他内容可保持不变。此屏幕中的默认设置即可满足要求。您需要选中“Create Activity”(创建活动)复选框并选择列表中的“Blank Activity”(空白活动)选项。同样,此处的默认选项即是您所需的设置。只需点击“Finish”(完成),然后 Eclipse 将会创建新项目的源代码。Eclipse 完成操作后,您可以尝试编译并运行您的新应用。此时您将会在另一个空的灰色屏幕上看到一条“Hello world!”消息。三:下载 Google Play 服务 SDKGoogle Play 服务 SDK 包含多个类和资源,您的应用可以用它们来请求和展示广告。请打开SDK Manager以确保您使用的是最新版本。您可以通过选择“Window”(窗口)>“Android SDK Manager”来查看您的 SDK Manager 是否是最新版本。在 Android SDK Manager 窗口中,请选择Extras文件夹下的Google Play services,然后按“Install Packages”(安装程序包)并接受许可协议以开始下载。如果“Install Packages”(安装程序包)按钮不能使用,请不要担心。这恰恰说明您已经拥有最新的版本,因此无需在 SDK Manager 中进行任何操作。四:加入 Google Play 服务库下载 Google Play 服务 SDK 后,您可以在项目中引用它。请从菜单中选择“File”(文件)>“New”(新建)>“Project…”(项目…)。选择 Android 文件夹,然后选择其中的 Android Project from Existing Code(从现有代码创建 Android 项目)。现在您只需告知 Eclipse 库所在的位置。选择“Browse”(浏览)按钮并转到<android-sdk>/extras/google/google_play_services/libproject/google-play-services_lib/,然后点击“OK”(确定)按钮。浏览对话框关闭后,您可以在“Projects”(项目)列表中看到一个条目。请确保选中该条目旁边的复选框,然后点击“Finish”(完成)以使用导入的代码创建一个新项目。五:引用导入的项目创建新项目后,您可以在应用的代码中引用它。在 Package Explorer 中右键点击 BannerExample,然后选择“Properties”(属性)。选择左侧属性列表部分中的 Android 选项,然后点击“Add…”(添加…)按钮。您将在列表视图中看到google-play-services_lib。选择该选项,然后点击“OK”(确定)关闭选择对话框,然后再关闭属性对话框。您的应用现在包含对Google Play 服务库项目的引用,这意味着您的应用可以使用 Google Play 服务 SDK 中包含的类和资源。请尝试重新构建和运行您的应用,以确保一切正常。您将不会看到任何变化,但添加 Google Play 服务是在应用中投放广告的第一步。六:修改清单文件您已拥有一个包含Google Play服务且可正常运行的应用,现在需要修改该应用的清单文件,以加入移动广告 SDK 所需的权限、版本号和活动定义。请打开 BannerExample 项目的 Android 清单AndroidManifest.xml以进行修改。该清单位于BannerExample/src/文件夹中,但具体路径取决于您设置项目时选择的程序包名称。<?xml version="1.0" encoding="utf-8"?><manifest xmlns:android="http://schemas.android.com/apk/res/android"package="com.google.android.gms.example.bannerexample" ><uses-sdk android:minSdkVersion="9"android:targetSdkVersion="21" /><!-- Include required permissions for Google Mobile Ads to run--><uses-permission android:name="android.permission.INTERNET"/><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/><application android:allowBackup="true"android:icon="@drawable/ic_launcher"android:label="@string/app_name"android:theme="@style/AppTheme" ><!--This meta-data tag is required to use Google Play Services.--><meta-data android:name="com.google.android.gms.version"android:value="@integer/google_play_services_version" /><activity android:name=".MainActivity"android:label="@string/app_name" > <intent-filter><action android:name="android.intent.action.MAIN" /><category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity><!--Include the AdActivity configChanges and theme. --><activity android:name="com.google.android.gms.ads.AdActivity"android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize"android:theme="@android:style/Theme.Translucent" /> </application> </manifest>您需要完成以下三项更改:1.为INTERNET和ACCESS_NETWORK_STATE 添加两个<uses-permission> 标记。INTERNET的标记是必需的,用于访问互联网以发送广告请求。ACCESS_NETWORK_STATE是可选的,用于在发出广告请求前检查是否有可用的互联网连接。2.添加一个引用 Google Play 服务版本的<meta-data>标记。这会让 Android 知道您的应用希望使用哪个版本的服务。3.添加具有configChanges和theme属性的<activity>元素。当横幅广告被点击或展示插页式广告时,SDK 会使用此活动,而且与其他活动一样,必须在展示之前在清单中声明此活动。七:为应用指定广告单元 ID广告单元 ID 是为您的应用中展示广告的位置指定的唯一标识符。如果您的应用包含两个活动(每个活动分别展示一个横幅广告),则会有两个广告单元,各自拥有自己的 ID。为了让您的新应用展示广告,您需要在其中加入广告单元 ID。请打开应用的字符串资源文件,该文件位于BannerExample/res/values/strings.xml。<?xml version="1.0" encoding="utf-8"?><resources> <string name="app_name">My Application</string> <string name="hello_world">Hello world!</string> <string name="action_settings">Settings</string> <string name="banner_ad_unit_id">ca-app-pub-3940256099942544/6300978111</string></resources>添加一个新的<string>标记(如上所示)。请注意,上面提供的广告单元 ID 仅用于测试。通过它您可以获取一个横幅广告示例,并确保您的实现正确无误。在开发和测试您的应用时,您应该始终使用测试广告,使用已发布的广告进行测试会违反 AdMob 政策,可能会导致您的帐户被暂停。请参见addTestDevice 方法的文档,以详细了解如何使用您的广告单元 ID 获得测试广告。八:在主活动布局中放置 AdView还需要执行两个步骤,您的应用就可以展示广告了。首先,您需要修改主活动的布局以加入一个AdView。请在编辑器中打开BannerExample/res/layout/activity_main.xml。<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent"xmlns:ads="http://schemas.android.com/apk/res-auto"android:layout_height="match_parent" android:paddingLeft="@dimen/activity_horizontal_margin"android:paddingRight="@dimen/activity_horizontal_margin"android:paddingTop="@dimen/activity_vertical_margin"android:paddingBottom="@dimen/activity_vertical_margin"tools:context=".MainActivity"><TextView android:text="@string/hello_world" android:layout_width="wrap_content"android:layout_height="wrap_content" /><com.google.android.gms.ads.AdViewandroid:id="@+id/adView"android:layout_width="wrap_content"android:layout_height="wrap_content"android:layout_centerHorizontal="true"android:layout_alignParentBottom="true"ads:adSize="BANNER"ads:adUnitId="@string/banner_ad_unit_id"></com.google.android.gms.ads.AdView></RelativeLayout>将以下两项内容添加到 XML:1.一个用于广告的命名空间:http://schemas.android.com/apk/res-auto。2.一个针对 AdView 的新元素。系统会要求您提供layout_width和layout_height。您可以将这两项都设置为wrap_content。在AdView标记中,将adSize设置为BANNER并将adUnitId设置为@string/banner_ad_unit_id。八 :在 MainActivity 类中加载广告您需要完成的最后一项更改是向应用的主活动类添加一些 Java 代码,以便将广告加载到AdView。打开您的MainActivity.java文件。该文件位于BannerExample/src/文件夹中,但具体的子目录路径取决于您在上文中创建项目时使用的网域。在编辑器中打开该文件后,在MainActivity类中查找 onCreate 方法:package ...import ...import ...import com.google.android.gms.ads.AdRequest;import com.google.android.gms.ads.AdView;public class MainActivity extends ActionBarActivity { protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); AdView mAdView = (AdView) findViewById(R.id.adView); AdRequest adRequest = new AdRequest.Builder().build(); mAdView.loadAd(adRequest); } ...}请执行以下两项更改:1.导入AdRequest和AdView类。2.添加将在布局中找到AdView的代码,并创建AdRequest,然后使用它将广告加载到AdView中。完成这两项更改后,您已大功告成!现在您应用的主活动中包含一个具有完整功能的AdView。九:享用新加载的广告KeyMob集合了多个主流的平台,在帮助开发者轻松集成多家广告平台的同时,平台随意切换并且还可以方便的进行应用交叉推广,大幅提高广告填充率,实现广告收益最大化。