很多网友对于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已经关闭,