AndroidManifest.xml文件剖析

很多网友对于Android全局配置文件AndroidManifest.xml不是很熟悉，今天我们就一起看下它完整的结构以及每个节点的作用。在我们日常的开发中都少不了下面的配置，每创建一个Activity、Service都离不开这个全局配置文件，深入的了解可以简化程序代码以及提高程序的维护性。

  在最外层包含了包名如 package="cn.android123.demo" 、软件的版本号    android:versionCode="1" 以及   android:versionName="1.0" ，里面一层的application分支中将可能包含Android程序的四种对象 Activity、Service、Content Provider以及Receiver。我们每添加上面四个类型中的任一新对象都需要在androidmanifest.xml文件中添加相应节点。

  其中Activity的属性常用的可能为android:name和android:label但我们需要了解所有的属性以帮助解决复杂的问题，完整的如下:  
          android:allowTaskReparenting=["true" | "false"]
          android:alwaysRetainTaskState=["true" | "false"]
          android:clearTaskOnLaunch=["true"" | "false"]
          android:configChanges=[one or more of: "mcc" "mnc" "locale"
                                 "touchscreen" "keyboard" "keyboardHidden"
                                 "navigation" "orientation" "fontScale"]
          android:enabled=["true" | "false"]
          android:excludeFromRecents=["true" | "false"]
          android:exported=["true" | "false"]
          android:finishOnTaskLaunch=["true" | "false"]
          android:icon="drawable resource"
          android:label="string resource"
          android:launchMode=["multiple" | "singleTop" |
                              "singleTask" | "singleInstance"]
          android:multiprocess=["true" | "false"]
          android:name="string"
          android:noHistory=["true" | "false"] 
          android:permission="string"
          android:process="string"
          android:screenOrientation=["unspecified" | "user" | "behind" |
                                     "landscape" | "portrait" |
                                     "sensor" | "nonsensor"]
          android:stateNotNeeded=["true" | "false"]
          android:taskAffinity="string"
          android:theme="resource or theme"
          android:windowSoftInputMode=[one or more of: "stateUnspecified"
                                       "stateUnchanged" "stateHidden"
                                       "stateAlwaysHidden" "stateVisible"
                                       "stateAlwaysVisible" "adjustUnspecified"
                                       "adjustResize" "adjustPan"] >

有关AndroidManifest.xml文件的application分支我们有必要了解一些常见的属性，这里可以看到一些我们实用的选项，比如允许调试android:debuggable、任务关系android:taskAffinity，比如我们常见的方式创建一个新的任务实用标记FLAG_ACTIVITY_NEW_TASK，为程序制定一个主题，可以使用android:theme指向一个主题文件。

  平时我们创建的程序使用一些安全敏感项，会需要请求系统许可权限，这里可以使用android:permission来制定相关的许可，每个程序的service、activity、content provider、receiver都需要在application的节点内实现。有关完整的属性可以查看:

<application android:allowClearUserData=["true" | "false"]
             android:allowTaskReparenting=["true" | "false"]
             android:debuggable=["true" | "false"]
             android:description="string resource"
             android:enabled=["true" | "false"]
             android:hasCode=["true" | "false"]
             android:icon="drawable resource"
             android:label="string resource"
             android:manageSpaceActivity="string"
             android:name="string"
             android:permission="string"
             android:persistent=["true" | "false"]
             android:process="string"
             android:taskAffinity="string"
             android:theme="resource or theme" >
    . . .
</application>

有关Androidmanifest.xml文件中的数据提供，我们来看下Provider节点中用到的定义，可以看到包含了权限控制、排序方式完整的如下:

<provider android:authorities="list"
          android:enabled=["true" | "false"]
          android:exported=["true" | "false"]
          android:grantUriPermissions=["true" | "false"]
          android:icon="drawable resource"
          android:initOrder="integer"
          android:label="string resource"
          android:multiprocess=["true" | "false"]
          android:name="string"
          android:permission="string"
          android:process="string"
          android:readPermission="string"
          android:syncable=["true" | "false"]
          android:writePermission="string" >
</provider>

而对于服务相关定义如下:

  <service android:enabled=["true" | "false"]
         android:exported[="true" | "false"]
         android:icon="drawable resource"
         android:label="string resource"
         android:name="string"
         android:permission="string"
         android:process="string" >
</service>

  最后是Broadcast使用的Receiver定义，一般配合<intent-filer> 和<meta-data>隐式处理。

  <receiver android:enabled=["true" | "false"]
          android:exported=["true" | "false"]
          android:icon="drawable resource"
          android:label="string resource"
          android:name="string"
          android:permission="string"
          android:process="string" >
</receiver>

Android蓝牙API之BluetoothAdapter类(1)

使用BluetoothAdapter类，你能够在Android设备上查找周边的蓝牙设备然后配对(绑定)，蓝牙通讯是基于唯一地址MAC来相互传输的，考虑到安全问题Bluetooth通讯时需要先配对。然后开始相互连接，连接后设备将会共享同一个RFCOMM通道以便相互传输数据，目前这些实现在Android 2.0或更高版本SDK上实现。

  一、查找发现 findding/discovering devices

  对于Android查找发现蓝牙设备使用BluetoothAdapter类的startDiscovery()方法就可以执行一个异步方式获取周边的蓝牙设备，因为是一个异步的方法所以我们不需要考虑线程被阻塞问题，整个过程大约需要12秒时间，这时我们紧接着注册一个BroadcastReceiver 对象来接收查找到的蓝牙设备信息，我们过滤ACTION_FOUND这个 Intent动作来获取每个远程设备的详细信息，通过附加参数在Intent字段EXTRA_DEVICE 和 EXTRA_CLASS, 中包含了每个BluetoothDevice 对象和对象的该设备类型 BluetoothClass ，示例代码

private final BroadcastReceiver cwjReceiver = new BroadcastReceiver() {
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction(); 
           if (BluetoothDevice.ACTION_FOUND.equals(action)) { 
             BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE); 
             myArrayAdapter.add(device.getName() + " android123 " + device.getAddress()); //获取设备名称和mac地址

        }
    }
};
// 注册这个 BroadcastReceiver
IntentFilter filter = new IntentFilter(BluetoothDevice.ACTION_FOUND);
registerReceiver(cwjReceiver, filter);

 最后android123提醒大家需要注意的是，记住在Service或Activity中重写onDestory()方法，使用unregisterReceiver方法反注册这个BroadcastReceiver对象保证资源被正确回收。

 一些其他的状态变化有 ACTION_SCAN_MODE_CHANGED 额外参数 EXTRA_SCAN_MODE 和 EXTRA_PREVIOUS_SCAN_MODE以及SCAN_MODE_CONNECTABLE_DISCOVERABLE、SCAN_MODE_CONNECTABLE和SCAN_MODE_NONE,

   二、配对绑定 bnded/paired device

  在Android中配对一个蓝牙设备可以调用BluetoothAdapter类的getBondedDevices()方法可以获取已经配对的设备，该方法将会返回一个BluetoothDevice数组来区分每个已经配对的设备，示例代码如下:

Set<BluetoothDevice> pairedDevices = cwjBluetoothAdapter.getBondedDevices();

if (pairedDevices.size() > 0)  //如果获取的结果大于0，则开始逐个解析
 {
    
    for (BluetoothDevice device : pairedDevices) {
 
        myArrayAdapter.add(device.getName() + " android123 " + device.getAddress());  //获取每个设备的名称和MAC地址添加到数组适配器myArrayAdapter中。
    }
}

 很多网友不明白如何让自己的手机被其他蓝牙设备发现如何设置，下面我们就一起来说说

  三、允许发现 enabling discoverability

  如果需要用户确认操作，不需要获取底层蓝牙服务实例，可以通过一个Intent来传递ACTION_REQUEST_DISCOVERABLE参数，这里通过startActivityForResult来强制获取一个结果，重写startActivityForResult()方法获取执行结果，返回结果有RESULT_OK和RESULT_CANCELLED分别代表开启和取消(失败)，当然最简单的方法是直接执行，示例代码如下

Intent cwjIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_DISCOVERABLE);
cwjIntent.putExtra(BluetoothAdapter.EXTRA_DISCOVERABLE_DURATION, 300);
startActivity(cwjIntent);

  接下来系统会提示用户是否允许，对话框如下

  

从Android 2.0开始提供最全面的蓝牙开发接口，API Level为5的系统才能调用，目前Android Bluetooth API包含了主要以下几类：BluetoothAdapter
BluetoothDevice、BluetoothSocket 、BluetoothServerSocket 和BluetoothClass 它们均在android.bluetooth这个包中出现。

  我们调用时除了需要考虑API Level至少为5外，还需注意添加相应的权限，比如使用通讯需要在androidmanifest.xml加入<uses-permission android:name="android.permission.BLUETOOTH" />，而开关蓝牙需要android.permission.BLUETOOTH_ADMIN权限。

  三、建立通讯 establishing

  对于建立一个蓝牙通讯，必须经过以下四个步骤：获取本地蓝牙设备、查找远程设备、配对(已配对设备将会忽略这步的细节)、连接设备和传输数据.

  在Android平台中首先我们需要查找本地活动的蓝牙适配器，通过BluetoothAdapter类的getDefaultAdapter() 方法获得一个系统默认可用的蓝牙设备，示例代码如下

  BluetoothAdapter cwjBluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
  if (cwjBluetoothAdapter == null) {
    // Android开发网提示大家本机没有找到蓝牙硬件或驱动存在问题
 }

 当然有了这步仍然不能建立连接，因为我们还不知道手机中的蓝牙功能是否被开启，可以通过cwjBluetoothAdapter的.isEnabled方法来判断，如果没有开启，我们可以通过下面的代码提醒用户启用:

  if (!cwjBluetoothAdapter.isEnabled()) {
    Intent TurnOnBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);
    startActivityForResult(TurnOnBtIntent, REQUEST_ENABLE_BT);
}
这时用户会收到类似下面的窗口:

 

  我们通过startActivityForResult()方法发起的Intent将会在onActivityResult()回调方法中获取用户的选择，比如用户单击了Yes开启，那么将会收到RESULT_OK 的结果，如果RESULT_CANCELED则代表用户不愿意开启蓝牙，当然android123提醒大家还可以通过其他方式来开启，比如说用BluetoothDevice获取蓝牙服务接口对象，是用enable()方法来开启，无需询问用户，这时就需要用到android.permission.BLUETOOTH_ADMIN权限。

 如何判断系统蓝牙的状态呢? 建立BroadcastReceiver对象，接收ACTION_STATE_CHANGED动作，在EXTRA_STATE和EXTRA_PREVIOUS_STATE包含了现在状态和过去的状态，最终的结果定义是STATE_TURNING_ON正在开启， STATE_ON已经开启， STATE_TURNING_OFF正在关闭和 STATE_OFF已经关闭，如果有什么不明白的可以在我们的论坛中交流。