Create an Android Things Project

创建一个 Android Things 项目

This lesson teaches you to

这门课让您学会

  1. Create a Things Project

  2. 创建一个 Android Things 项目

  3. Create a Home Activity

  4. 创建一个主页面

You should also read

您需要阅读

Things apps use the same structure as those designed for phones and tablets. This similarity means you can modify your existing apps to also run on embedded things or create new apps based on what you already know about building apps for Android.

Android Things 应用的结构和为手机或平板所设计的应用的结构一样。它们之间的相似性意味着您可以把您现存的应用修改并移植在嵌入式 Android Things 设备上，或者是可以基于您对 Android 应用开发的认知来创建一个全新的 Android Things 应用。

This lesson describes how to prepare your development environment for Android Things, and the required changes to enable app to run on embedded things.

这节课将描述如何准备 Android Things 开发环境，以及一些让应用可以在嵌入式设备上运行所必须的修改项。

Prerequisite

前提

Before you begin building apps for Things, you must:

在您为构建 Android Things 应用之前，您必须

Get to start

开始

To get started quickly, create your app project using the new project wizard:

您可以使用这个新建项目引导来快速创建 应用项目：

  • Select Android Things as the only form factor.

  • 选择项目类型为 Android Things。

  • In order to access new APIs for Things, target Android 8.0 (Oreo), API level 26 or higher.

  • 为了使用最新的 API ，请确保构建目标为 Android 8.0 (Oreo), API 26 ，或者更高。

  • Name the new empty activity HomeActivity.

  • 将新建的空白页面命名为 HomeActivity。

The new project wizard automatically adds two necessary items to your Android Studio project: a dependency to the Android Things support library and a default launch activity.

新建项目引导将自动为您的 Android Studio 项目添加两个必须项: 一个是 Android Things 中的 支持库 的依赖关系，以及一个默认 页面.

Add libraries

添加库

Android Things devices expose APIs through support libraries that are not part of the Android SDK. The new project wizard automatically adds a dependency to the support library to your app-level build.gradle file:

Android Things 利用不属于 Android SDK 一部分的支持库来暴露 API 接口。新建项目引导将自动在应用层的 build.gradle 添加支持库的依赖关系。

  1. dependencies {
  2.     compileOnly 'com.google.android.things:androidthings:+'    
  3. }

The wizard adds <uses-library> to your app’s manifest file to make this prebuilt library available to the app’s classpath at run time.

该项目引导将 <uses-library> 添加到应用的 mainfest 文件中，以确保这些预构建的库在应用运行时处于可用状态。

Add an activity

添加一个主页面

An application intending to run on an embedded device must declare an activity in its manifest as the main entry point after the device boots. Note that the wizard applies an intent filter containing the following attributes:

一个为嵌入式设备所构建的应用，需要在其 mainfest 文件中指定一个主页面作为设备启动后的入口。请注意，向导通过包含下面这些属性去申请一个 intent filter ：(请校对者帮忙参考)

For ease of development, this same activity includes a CATEGORY_LAUNCHER intent filter so Android Studio can launch it as the default activity when deploying or debugging.

为了便于开发，相同的页面包括了这个 CATEGORY_LAUNCHER intent filter ，所以在部署或者调试时，Android Studio 可以加载这个页面作为默认页面。

  2. <application>    
  3.     <uses-library android:name="com.google.android.things"/>    
  4.     <activity android:name=".HomeActivity">        
  5.         <!-- Launch activity as default from Android Studio -->        
  6.         <intent-filter>            
  7.             <action android:name="android.intent.action.MAIN"/>            
  8.             <category android:name="android.intent.category.LAUNCHER"/>        
  9.         </intent-filter>        
  10.         <!-- Launch activity automatically on boot -->        
  11.         <intent-filter>            
  12.             <action android:name="android.intent.action.MAIN"/>            
  13.             <category android:name="android.intent.category.IOT_LAUNCHER"/>            
  14.             <category android:name="android.intent.category.DEFAULT"/>        
  15.         </intent-filter>    
  16.     </activity>
  17. </application>