Android中文API.docx
《Android中文API.docx》由会员分享，可在线阅读，更多相关《Android中文API.docx（27页珍藏版）》请在冰豆网上搜索。
Android中文API
Android中文API合集（50篇）
Android中文翻译组
关于
API文档（Reference）是Android开发的基础，三年来（2007-2010）官方仍未出中文版的API，Android中文翻译组聚一批从事Android开发人员、论坛版主、大学生、研究生等利用业余时间对Android的API进行翻译，人数从1人到80+人不断壮大，发表的译文从1篇到50篇不断增多，为的只是多一份Android中文资料，欢迎更多朋友的加入，联系我们：
QQ：
36408253 Gtalk：
over140@
欢迎大家访问翻译组在淘蝌蚪上搭建的项目：
http:
//code.taobao.org/project/view/404/（cnAndroid），可使用SVN客户端匿名下载：
http:
//code.taobao.org/svn/cnAndroid，在这里可以查看翻译组当前的最新的进度和翻译稿，也可以直接向我们提问。
关于翻译组的更多介绍，请看这里。
章节
命名空间
完成章节数
android
3
android.accessibilityservice
1
android.view
2
android.widget
46
结构
继承关系
publicfinalclassManifestextendsObject
java.lang.Objectandroid.Manifest
内部类
classManifest.permission
权限
classManifest.permission_group
权限组
构造函数
publicManifest（）
构造函数
补充
文章精选
androidManifest.xml选项
Manifest.permission
结构
继承关系
publicstaticfinalclassManifest.permissionextendsObject
java.lang.Object
android.Manifest.permission
常量
ACCESS_CHECKIN_PROPERTIES
允许在登入数据库的时候读写其中的属性表，并上传改变的值
ACCESS_COARSE_LOCATION
允许应用访问范围（如WIFI）性的定位
ACCESS_FINE_LOCATION
允许应用访问精确（如GPS）性的定位
ACCESS_LOCATION_EXTRA_COMMANDS
允许应访问额外的提供定位的指令
ACCESS_MOCK_LOCATION
允许应用创建用于测试的模拟定位提供者
ACCESS_NETWORK_STATE
允许应用访问网络上的信息
ACCESS_SURFACE_FLINGER
允许应用使用低版本视图的特征
ACCESS_WIFI_STATE
允许应用访问关羽Wi-Fi网络的信息
ACCOUNT_MANAGER
允许应用进入帐户认证
AUTHENTICATE_ACCOUNTS
允许应用为ACCOUNT_MANAGER扮演一个帐户认证系统
BATTERY_STATS
允许应用去统计电源信息
BIND_APPWIDGET
允许应用告诉AppWidget哪个应用能够访问该AppWidget的数据
BIND_DEVICE_ADMIN
必须通过关机接收者的请求来确保只有系统能够与之交互
BIND_INPUT_METHOD
必须通过InputMethodService的请求来确保只有系统能够与之绑定
BIND_WALLPAPER
必须通过WallpaperService的请求来确保只有系统能够与之绑定
BLUETOOTH
允许应用去连接蓝牙设备
BLUETOOTH_ADMIN
允许应用找到与之连接的蓝牙设备
BRICK
被请求废止设备（非常危险）
BROADCAST_PACKAGE_REMOVED
允许应用发出一个程序包被移除的广播消息
BROADCAST_SMS
允许应用发出一个收到短信的消息
BROADCAST_STICKY
允许应用发出一个与intent相连的消息
BROADCAST_WAP_PUSH
允许应用发出一个收到WAPPUSH的广播消息
CALL_PHONE
允许应用启动一个用户确认电话被拨打而不通过拨打电话的用户界面的的拨打程序
CALL_PRIVILEGED
允许应用启动一个用户确认电话被拨打而不通过拨打电话的用户界面的的任意号码的拨打，包括紧急号码.
CAMERA
能够启动照相机设备的请求
CHANGE_COMPONENT_ENABLED_STATE
允许应用去改变一个应用是否是激活状态
CHANGE_CONFIGURATION
允许应用修改当前的配置，如本地设置
CHANGE_NETWORK_STATE
允许应用改变网络的连接状态
CHANGE_WIFI_MULTICAST_STATE
允许应用进入Wi-Fi的组播方式
CHANGE_WIFI_STATE
允许应用改变Wi-Fi的连接状态
CLEAR_APP_CACHE
允许应用清除所有安装在设备上的应用的缓存
CLEAR_APP_USER_DATA
允许应用清除使用者的信息资料
CONTROL_LOCATION_UPDATES
允许从广播设备来更新或不更新本地的消息
DELETE_CACHE_FILES
允许应用删除掉缓存文件
DELETE_PACKAGES
允许应用删除掉程序包
DEVICE_POWER
允许低权限的访问电源管理项
DIAGNOSTIC
允许应用诊断程序资源
DISABLE_KEYGUARD
允许应用禁用键盘锁
DUMP
允许应用从系统服务中恢复转储的信息
EXPAND_STATUS_BAR
允许应用扩大或缩小状态栏
FACTORY_TEST
如制造商测试的应用一样用终极权限用户运行
FLASHLIGHT
允许访问手电筒
FORCE_BACK
允许应用强制的返回操作而不论是不是最终的activity
GET_ACCOUNTS
允许应用访问账目服务中的统计清单
GET_PACKAGE_SIZE
允许应用查找出任何程序包使用的空间
GET_TASKS
允许应用找到关于当前或最近运行的任务和在哪些acitivities里运行
GLOBAL_SEARCH
这个权限可以被内容提供者用来允许使用全程搜索他们的数据
HARDWARE_TEST
允许访问硬件及周边设备.
INJECT_EVENTS
允许应用注入用户事件（键盘、触摸）到事件中然后提供给任意的窗口
INSTALL_LOCATION_PROVIDER
允许应用安装一个位置提供商到位置管理器中
INSTALL_PACKAGES
允许应用安装程序包.
INTERNAL_SYSTEM_WINDOW
允许应用打开被部分系统用户接口使用的窗口
INTERNET
允许应用打开网络套接口
KILL_BACKGROUND_PROCESSES
允许应用去呼叫killBackgroundProcesses（String）.方法
MANAGE_ACCOUNTS
允许应用去管理帐户管理者中的重要清单
MANAGE_APP_TOKENS
允许应用去管理（创建、销毁、顺序）在窗口管理者中的应用
MASTER_CLEAR
MODIFY_AUDIO_SETTINGS
允许应用修改全局音频设定
MODIFY_PHONE_STATE
允许改变拨打电话的状态-电源等
MOUNT_FORMAT_FILESYSTEMS
允许格式化可移除的存储仓库的文件系统
MOUNT_UNMOUNT_FILESYSTEMS
允许装备或解除可移除的存储仓库的文件系统
PERSISTENT_ACTIVITY
允许应用使它的activities更持久稳固
PROCESS_OUTGOING_CALLS
允许应用监督、限定或终止呼出的电话
READ_CALENDAR
允许应用读取用户的日历数据
READ_CONTACTS
允许应用读取用户的联系人数据
READ_FRAME_BUFFER
允许应用抓取屏幕和更多可获得的缓冲数据
READ_HISTORY_BOOKMARKS
允许应用去读取（非写）用户浏览历史和书签
READ_INPUT_STATE
允许应用去的当前键盘和控制的状态
READ_LOGS
允许应用读取低级别的系统日志文件
READ_OWNER_DATA
允许应用读取所有者的数据
READ_PHONE_STATE
允许读取电话的状态
READ_SMS
允许应用读取短信息.
READ_SYNC_SETTINGS
允许应用读取同步的设置
READ_SYNC_STATS
允许应用读取同步的统计数据
REBOOT
重新启动设备的请求
RECEIVE_BOOT_COMPLETED
允许应用接收在系统完成启动后发出的ACTION_BOOT_COMPLETED广播信息
RECEIVE_MMS
允许应用去监听多媒体信息并记录和对起进行处理
RECEIVE_SMS
允许应用去监听短消息并记录和对起进行处理
RECEIVE_WAP_PUSH
允许应用监听WAPpush信息
RECORD_AUDIO
允许应用记录音频信息
REORDER_TASKS
允许应用改变任务的关系位置
RESTART_PACKAGES
已废弃使用
SEND_SMS
允许应用发送短消息.
SET_ACTIVITY_WATCHER
允许应用查看和控制activities是怎样在系统中运行的
SET_ALWAYS_FINISH
允许应用去控制当activities被覆盖后是否是立即接触结束
SET_ANIMATION_SCALE
改变动画的比例因子
SET_DEBUG_APP
设置一个应用为调试模式
SET_ORIENTATION
允许低级别的设置屏幕的方向
SET_PREFERRED_APPLICATIONS
已废弃
SET_PROCESS_LIMIT
允许应用设置可以运行的最大数的应用进程
SET_TIME
允许应用设置系统时间
SET_TIME_ZONE
允许应用设置系统时区时间
SET_WALLPAPER
允许应用设置壁纸
SET_WALLPAPER_HINTS
允许应用设置锁定的壁纸
SIGNAL_PERSISTENT_PROCESSES
允许应用发出一个给所有稳定进程信号的请求
STATUS_BAR
允许应用打开、关闭或使状态栏或图标失去作用
SUBSCRIBED_FEEDS_READ
允许应用访问内容提供者的签署认证
SUBSCRIBED_FEEDS_WRITE
SYSTEM_ALERT_WINDOW
允许应用使用TYPE_SYSTEM_ALERT来打开窗口，并将窗口显示于其他应用的顶端
UPDATE_DEVICE_STATS
允许应用更新设备资料信息
USE_CREDENTIALS
允许应用从管理器得到授权请求
VIBRATE
允许应用访问震动器
WAKE_LOCK
允许使用电源锁定管理以使进程休眠或屏幕变暗
WRITE_APN_SETTINGS
允许应用去写入接入点设置
WRITE_CALENDAR
允许应用写（非读）用户的日历数据
WRITE_CONTACTS
允许应用写（非读）用户的联系人数据
WRITE_EXTERNAL_STORAGE
允许应用写（非读）用户的外部存储器
WRITE_GSERVICES
允许应用修改Google服务地图
WRITE_HISTORY_BOOKMARKS
允许应用写（非读）用户的浏览器历史和书签
WRITE_OWNER_DATA
允许应用写（非读）用户的数据
WRITE_SECURE_SETTINGS
允许应用写或读当前系统设置
WRITE_SETTINGS
允许应用写或读系统设置
WRITE_SMS
允许应用写短消息信息
WRITE_SYNC_SETTINGS
允许应用写同步设置
结构
继承关系
publicstaticfinalclassManifest.permission_groupextendsObject
java.lang.Object
android.Manifest.permission_group
常量
ACCOUNTS
直接通过统计管理器访问管理的统计
COST_MONEY
可以用来让用户花钱但不需要通过与他们直接牵涉的权限
DEVELOPMENT_TOOLS
与开发联盟特征相连的权限组
HARDWARE_CONTROLS
被用来提供直接访问硬件设备的权限
LOCATION
用来允许访问用户的当前位置的权限
MESSAGES
用来允许应用发送用户收到的被拦截的信息
NETWORK
用来提供访问网络服务的权限
PERSONAL_INFO
用于提供访问用户私人数据如联系人、日历、电子邮件等的权限
PHONE_CALLS
用于跟访问和修改拨号状态如截取去话信息、读取和修改电话状态等的权限
STORAGE
与SD卡访问相关联的权限组
SYSTEM_TOOLS
与系统API有关联的权限组
结构
publicabstractclassAccessibilityServiceextendsService
java.lang.Object
android.content.Context
android.content.ContextWrapper
android.app.Service
android.accessibilityservice.AccessibilityService
类概述
当AccessibilityEvent事件被启动后AccessibilityService 会接收回调函数运行于后台，这些事件指的是在用户接口间的状态转换，比如,焦点变化，按钮被点击等。
一些辅助服务继承于此类并且实现它的抽象方法，像这样的一个服务和其他服务一样在AndroidManifest.xml中被声明但它必须被指定操纵“android.accessibilityservice.
AccessibilityService”的意图，下面的是一段例子：
辅助服务的声明周期只能被系统管理，启动或者停止这个服务必须由明确的用户通过启用或停用设备的设定，在系统通过呼叫onServiceConnected（）方法与服务绑定后，这个方法才能被想要执行装载的客户端所重载使用，一个辅助服务通过呼叫setServiceInfo（AccessibilityServiceInfo）方法来设定AccessibilityServiceInfo而配置。
你可以在任何时候改变这个服务的配置但最好是在重载方法onServiceConnected（）.中来使用。
一个辅助服务可以在特定的包中注册事件以提供特殊的反馈类型并且当最后一个关联的事件被解除的时候发出明确的超时提醒。
通告策略
对于每个回馈类型只有一个辅助服务被通知，服务登记处按顺序被通知，因此，如果有两个服务为同一个包中的同一回馈类型注册那么第一个会被通知，然而有可能的是，可以为一个给定的回馈类型去把一个服务注册为默认的，这样的话如果没有其他的服务来取代这个事件这个服务就会被呼出使用，换句话说，默认的服务不会与其他的服务竞争并且不管注册的顺序而被通知。
常量
String SERVICE_INTERFACE
声明Intent必须由这个服务来处理
公共方法
abstractvoidonAccessibilityEvent（AccessibilityEventevent）
参数
event 一个事件
publicfinalIBinderonBind（Intentintent）
实现返回一个内部的辅助接口的实现，子类不能被重写。
参数
intent 与服务相绑定的意图，注意其他任何包含在Intent的外部意图将不能在此使用。
返回值
返回一个客户端可以在服务上访问的IBinder。
publicabstractvoidonInterrupt（）
打断辅助回馈内容时呼叫。
受保护方法
protectedvoidonServiceConnected（）
这个方法是AccessibilityService声明周期的一部分，在系统成功与服务绑定后才被呼叫，如果用来设定AccessibilityServiceInfo.这个方法更为方便。
java.lang.Object
android.view.View
直接子类：
AnalogClock,ImageView,KeyboardView,ProgressBar,SurfaceView,TextView,ViewGroup,ViewStub
间接子类：
AbsListView,AbsSeekBar,AbsSpinner,AbsoluteLayout,AdapterView,AppWidgetHostView,AutoCompleteTextView,Button,CheckBox,CheckedTextView,Chronometer,CompoundButton,DatePicker,DialerFilter,DigitalClock,EditText,ExpandableListView,ExtractEditText,FrameLayout,GLSurfaceView,Gallery,GestureOverlayView,GridView,HorizontalScrollView,ImageButton,ImageSwitcher,LinearLayout,ListView,MediaController,MultiAutoCompleteTextView,QuickContactBadge,RadioButton,RadioGroup,RatingBar,RelativeLayout,ScrollView,SeekBar,SlidingDrawer,Spinner,TabHost,TabWidget,TableLayout,TableRow,TextSwitcher,TimePicker,ToggleButton,TwoLineListItem,VideoView,ViewAnimator,ViewFlipper,ViewSwitcher,WebView,ZoomButton,ZoomControls
XML属性
属性名称
描述
android:
background
设置背景色/背景图片。
可以通过以下两种方法设置背景为
透明：
"@android:
color/transparent"和"@null"。
注意
TextView默认是透明的，不用写此属性，但是
Buttom/ImageButton/ImageView想透明的话就得写这个属
性了。
android:
clickable
是否响应点击事件。
android:
contentDescription
设置View的备注说明，作为一种辅助功能提供，为一些没
有文字描述的View提供说明，如ImageButton。
这里在界
面上不会有效果，自己在程序中控制，可临时放一点字符
串数据。
android:
drawingCacheQuality
设置绘图时半透明质量。
有以下值可设置：
auto（默认，
由框架决定）/high（高质量，使用较高的颜色深度，消耗
更多的内存）/low（低质量，使用较低的颜色深度，但是
用更少的内存）。
android:
duplicateParentState
如果设置此属性，将直接从父容器中获取绘图状态（光标，
按下等）。
见下面代码部分，注意根据目前测试情况仅仅是
获取绘图状态，而没有获取事件，也就是你点一下
LinearLayout时Button有被点击的效果，但是不执行点击事
件。
android:
fadingEdge
设置拉滚动条时 ，边框渐变的放向。
none（边框颜色不
变），horizontal（水平方向颜色变淡），vertical
（垂直方向颜色变淡）。
参照fadingEdgeLength的
效果图
android:
fadingEdgeLength
设置 边框渐变的长度。
android:
fitsSystemWindows
设置布局调整时是否考虑系统窗口（如状态栏）
android:
focusable
设置是否获得焦点。
若有requestFocus（）被调用时，后者
优先处理。
注意在表单中想设置某一个如EditText获取焦
点，光设置这个是不行的，需要将这个EditText前面的
focusable都设置为false才行。
在Touch模式下获取焦点
需要设置focusableInTouchMode为true。
android:
focusableInTouchMode
设置在Touch模式下View是否能取得焦点。
android:
hapticFeedbackEnabled
设置触感反馈。
（译者注：
按软键以及进行某些UI交互时振动，暂时不知道用法，大家可以找找performHapticFeedback或HapticFeedback这个关键字的资料看看。
）
android:
id
给当前View设置一个在当前layout.xml中的唯一编号，可
以通过调用View.findViewById（）或Activity.findViewById（）
根据这个编号查找到对应的View。
不同的layout.xml之间
定义相同的id不会冲突。
格式如”@+id/btnName”
android:
isScrollContainer
设置当前View为滚动容器。
这里没有测试出效果来，
ListView/GridView/ScrollView根本就不用设置这个属性，
而EdidText设置android:
scrollbars也能出滚动条。
android:
keepScreenOn
View在可见的情况下是否保持唤醒状态。
常在LinearLayout使用该属性，但是模拟器这里没有效果。
android:
longClickable
设置是否响应长按事件.
android:
minHeight
设置视图最小高度
android:
minWidth
设置视图最小宽度度
android:
nextFo
升级会员 