【Android翻译】Support Library Setup

自己翻译的,按照意思翻个大概,留着参考,凑合着看吧。
原文是:Android官网的《Support Library Setup

你在你开发的项目中配置什么Android Support Libraries,
取决于你想要用什么特性和你想要你的应用支持到哪个Android平台。
这个文档会教你下载Support Library包并把它加到你的开发环境中。

下载 Support Library

Android Support Library包是作为Android SDK的补充而提供下载的,
它通过Android SDK Manager来获得。请按照下面的说明来获得Support Library文件。

To download the Support Library through the SDK Manager:
通过SDK Manager下载Support Library:

  1. 打开Android SDK Manager
  2. 在SDK Manager的窗口,把Packages列表滚动到底部,找到Extras这个目录,
    如果有必要的话,点击目录小箭头让它展开具体的内容。
  3. 选择Android Support Library这个选项。
    注意:如果你是用Android Studio开发的,则是进行选择并安装Android Support Repository的操作。
  4. 点击Install packages...按钮。
    (我:这里可能是“Install 几个 packages”的按钮,然后有个弹窗问你接不接受,那肯定要接受才行的。)

上图是已在Android SDK Manager中选择了Android Support Library 。

下载完成后,你的Android SDK目录就会安装Support Library的文件。
Support Library那些文件会在你 SDK:<sdk>/extras/android/support/directory 的目录。

选择Support Library

Before adding a Support Library to your application, decide what features you want to include and the lowest Android versions you want to support. For more information on the features provided by the different libraries, see Support Library Features.

在添加一个Support Library到你的应用之前,
要先决定你想要支持什么特性和你想要支持的Android最低版本。
更多关于不同Library提供什么特性的信息,可以参考官网《Support Library Features》这篇介绍(另外,还可以参考这篇《Android各个Support Library介绍》)。

添加Support Library

为了使用Support Library,你必须修改在你开发环境中应用程序项目的classpath dependencies(姑且叫它“环境变量依赖关系”吧)。对于每个你想要去使用的Support Library,你都必须要执行这个“修改”的操作。

一些Support Library除了编译的类,还包含一些图片和XML文件这样的资源。
例如,v7 appcompatv7 gridlayout

如果你不确定某个Support Library是否包含这些资源,可以通过Support Library Features 这个页面来检查。下面的内容将讲述如何为你的应用程序项目添加 有或者没有 资源文件的Support Library。

添加没有资源文件的Library

要为你的项目添加一个没有资源文件的Support Library:

  1. 请确保你已经在SDK Manager下载了 Android Support Repository
  2. 打开你应用程序的build.gradle文件;
  3. dependencies这部分代码中,添加support library。例如,要增加v4这个support library,就加下面这一行代码:
dependencies {    
...    
compile "com.android.support:support-v4:18.0.+" 
}

添加有资源文件的Library

To add a Support Library with resources (such as v7 appcompat for action bar) to your application project:
要为你的项目添加一个有资源文件的Support Library(例如 v7 appcompat的action bar):

  1. 请确保你已经在SDK Manager下载了 Android Support Repository
  2. 打开你应用程序的build.gradle文件;
  3. dependencies这部分代码中,添加support library特性标识符。例如,要增加appcompat项目,在dependencies这部分代码增加"com.android.support:appcompat-v7:18.0.+"这句,就像下面这样:
dependencies {    
...    
compile "com.android.support:appcompat-v7:18.0.+"
}

使用Support Library的API

Support Library那些为现有框架API提供支持的类,通常跟框架的类有相同的名字,
但是它们是位于android.support class的包,或者有一个*Compat这样的后缀。

特别提醒:当你用Support Library那些类的时候,一定要确保你import的类是来自合适的包。例如,当要用ActionBar的类:

  • 使用Support Library时是android.support.v7.app.ActionBar
  • 在API level 11或以上开发时是android.app.ActionBar

请注意:在你的项目包含了Support Library后,我们强烈推荐你在应用APK发布之前使用ProGuard这个工具。它除了可以保护你的源代码,还可以把你应用中包含了的那些Library中无用的代码移除掉,这样就能够让你的应用尽可能小。更多信息请点击ProGuard的页面阅览。

【截取自ProGuard 的页面】ProGuard 工具通过移除无用的代码以及使用语义隐晦的名称来重命名类、字段和方法,从而达到压缩、优化和混淆代码的目的。最终您将获得一个较小的 .apk文件,此文件更难于进行反向工程。由于 ProGuard 会使应用更难于进行反向工程,因此当应用使用对安全性要求极高的功能时(例如,当您向应用授予许可时),您必须使用此工具。

Android developer官网的training, guides和samples提供了更多关于Support Library的用法。更多关于某一个Support Library类和方法的信息,可以在“API 参考”的页面点击 android.support查看。

Manifest Declaration Changes

如果你正通过添加Support Library到早期的Android API来为你现有的应用做向下兼容,请记住要修改你应用的manifest。特别要记住,要去更新manifest中<uses-sdk>
这一项标签里面的android:minSdkVersion,把它更称更低的版本号,像下面这样:

 <uses-sdk
      android:minSdkVersion="7"
      android:targetSdkVersion="17" />

manifest的设置会告诉Google Play,你的应用可以安装在Android 2.1 (API level 7) 和以上版本的设备。

如果你是用Gradle来构建文件,则在build文件中修改minSdkVersion的设置。

apply plugin: 'com.android.application'

android {
    ...

    defaultConfig {
        minSdkVersion 8
        ...
    }
    ...
}

这种情况下,build文件的设置会告诉Google Play你应用的build variant可以安装在Android 2.2 (API level 8) 和以上版本的设备。更多关于build variant的信息,请参考 Build System Overview

因为build variant又是另一个知识点,所以就不翻译了。
……
好吧,其实是我不会

请注意:如果你是在你的应用中包含v4 support和v7 appcompat的Library,
你应该将minimum SDK版本指定为"7"(而不是"4")。
你引入到你项目的最高版本Support Library决定了应用可以运行的最低API版本。

代码示例

Each Support Library includes code samples to help you get started using the support APIs. The code is included in the download from the SDK Manager and is placed inside the Android SDK installation directory, as listed below:
每个Support Library都包含代码示例来帮助你上手它的API。从SDK Manager的下载后就会有这些代码,它们是放在Android SDK的安装目录,如下所示:

  • 4v Samples: <sdk>/extras/android/support/samples/Support4Demos/
  • 7v Samples: <sdk>/extras/android/support/samples/Support7Demos/
  • 13v Samples: <sdk>/extras/android/support/samples/Support13Demos/
  • App Navigation: <sdk>/extras/android/support/samples/SupportAppNavigation/
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,588评论 6 496
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,456评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,146评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,387评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,481评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,510评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,522评论 3 414
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,296评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,745评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,039评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,202评论 1 343
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,901评论 5 338
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,538评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,165评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,415评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,081评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,085评论 2 352

推荐阅读更多精彩内容