zzhoujay/markdown

Android平台下的原生Markdown解析器

markdown's Issues

代码区域可以不断行，显示在一行，然后点击的时候全屏查看

请发布一个当前master分支带自定义主题功能的1.0.6版本

亲，后来添加的主题功能代码没有发布到1.0.5。用户没法自定义主题，更新一个新的带用户自定义主题的1.0.6版本吧。

Markdown可以添加把md转换为html文本的功能吗？

这样可以把显示功能完全交给浏览器去做

图片格式解析

图片1![adds][1]
图片2![sdfs][2]
[1]: http://img.my.csdn.net/uploads/201309/01/1378037235_3453.jpg
[2]: http://img.my.csdn.net/uploads/201309/01/1378037235_9280.jpg

这种格式的图片加载，不支持

代码块过长时不支持左右拖动？

当markdown比较大的时.就stackoverflow了

图片有的不显示.br标签和a标签直接显示出来.版本0.1.0. 文本如下

数据结构概论

数据结构是计算机存储、组织数据的方式。常见的数据结构分类方式如下图：



常用的线性结构有：线性表，栈，队列，循环队列，数组。线性表中包括顺序表、链表等，其中，栈和队列只是属于逻辑上的概念，实际中不存在，仅仅是一种**，一种理念；线性表则是在内存中数据的一种组织、存储的方式。

顺序表

顺序表将元素一个接一个的存入一组连续的存储单元中，在内存物理上是连续的。如下图：



顺序表存储密度较大，节省空间；但需要事先确定容量，在时间性能方面，读运算较快，时间复杂度为O(1)；查找运算为O(n/2)，和链表同样；插入运算和删除运算如果要操作中间一个元素，比如3，那么就需要把3后面的元素全部进行移动，因此时间复杂度相对链表要大一些，插入时间复杂度最好为O(0)或最坏为O(n)；删除时间复杂度为O([n-1]/2)；

链表

链表拥有很多结点，每个结点前半部分是数据域，后半部分是指针域，指针域指针指向下一个结点；链表可分为单链表、循环链表和双链表。

单链表：

从上图可以看出，单链表的上一个结点指针指向下一个结点，最后一个结点的指针域为null。
结点的删除：



删除一个结点，如删除上图中q结点，只需将p结点中的指针域指向a3，然后将a2释放掉（free）即可。
结点的插入：



插入一个结点，如插入上图中s结点，首先将s的指针域指向a2（也就是把s的next赋值为p的next），然后将p结点的指针域指向x即可（p的next指向x）。

循环链表



循环链表与单链表唯一不同之处是，循环链表的最后一个结点指针不为空，而是指向头结点。结点的插入和删除和单链表非常相似，就不再示范了。

双链表



双链表拥有一前一后两个指针域，从两个不同的方向把链表连接起来，如此一来，从两个不同的方向形成了两条链，因此成为双链表。因此，双链表的灵活度要大于单链表。
结点的删除：



双链表的操作比单链表要稍显复杂（按照单链表思路来做其实也不难），如上图，要删除p节点，首先需要将a1的后驱指向a3，然后将a3的前驱指向a1，最后将p节点释放掉即可。
结点的插入:



如上图，插入q结点，首先要按照方向，将步骤拆分，首先将q节点的前驱指向p结点后驱，紧接着将x后驱指向a2；然后按照顺序完成图中所示的3、4步即可。（经@llhhyy1989 @voteforvip @wanghuan203 三位童鞋的指正，发现此处有误，正确插入方法可查看评论，为保留错误原文不做改动！不懂具体插入过程可移步：http://hiphotos.baidu.com/zhidao/pic/item/b58f8c54fee5c3663a2935e0.jpg）
从空间性能来看，链表的存储密度要差一些，但在容量分配上更灵活一些。从时间性能来看，查找运算与顺序存储相同，插入运算和删除运算的时间复杂度为O(1)，要更优于顺序存储，但读运算则弱一些，为O([n+1]/2)，最好为1，最坏为n。

栈

上面提到栈属于一个逻辑概念，栈的实现可以用顺序也可以用链式。它遵循先进后出原则，如下图：



Java中测试代码如下：

package com.snail.test;

import java.util.Stack;

public class TestStack {

    public static void main(String[] args) {

        Stack<String> stack = new Stack<String>();
        stack.push("NO1");
        stack.push("NO2");
        stack.push("NO3");

        System.out.println("初始数量：" + stack.size());

        while(!stack.isEmpty()){
            System.out.println(stack.pop());
        }   

        System.out.println("取完后的数量：" + stack.size());
    }
}

输出结果顺序为：初始数量：3，NO3，NO2，NO1，取完后的数量：0。

队列

队列遵循先进先出的原则，如下图：



Java中测试代码如下：

package com.snail.test;  

/** 
 * 
 * @author Zang XT 
 */  
import java.util.Queue;  
import java.util.LinkedList;  
public class TestQueue {  
    public static void main(String[] args) {  
        Queue<String> queue = new LinkedList<String>();  

        queue.offer("NO1");  
        queue.offer("NO2");  
        queue.offer("NO3");  

        System.out.println("初始数量" + queue.size());  
        String str;  
        while((str=queue.poll())!=null){  
            System.out.println(str);  
        }  
        System.out.println("取出后数量" + queue.size());  
    }  
}  

运行结果顺序为：初始数量3，NO1，NO2，NO3，取出后数量0。
队列还有一种形式为循环队列，如下图：



循环队列有两个指针，头指针head和尾指针tail，尾指针一般指向的不是队尾元素实际地址，而是指向实际地址的下一个空地址，因此，循环队列一般牺牲最后一个空间，用来计算该队列是否满了，判断方式是tail+1 = head，既该队列已满。

树

一、树(Tree）定义

是n（n>=0)个结点的有限集。n=0时称为空树。在任意一棵非空树中：
（1）有且仅有一个特定的称为根（root）的结点。
（2）当n>1时，其余结点可分为m（m>0)个互不相交的有限集T1,T2,....,Tm, 其中每一个集合本身又是一棵树，并且称为根的子树（SubTree)，如图1所示：



树的定义之中还用到了树的概念，即递归定义。如图2中的子树T1和T2就是根结点A的子树。当然D,G,H,I组成的的树又是B结点的子树，E,J 组成的树是C结点的子树。



对于树的定义还需要注意两点：

1. n>0时根结点是唯一的，不可能存在多个根结点。
2. m>0时，子树的个数没有限制，但它们一定是互不相交的。如图3中的两个结构就不符合树的定义，因为它们都有相交的子树。

二、树的结点

树的结点包含一个数据元素及若干指向其子树的分支。结点拥有的子树称为结点的度（Degree）。度为0的结点称为叶结点（Leaf）或终端结点；度不为0的结点称为非终端结点或分支结点，除根结点之外，分支结点也称为内部结点。树的度是树内各结点的度的最大值。如图4，因为这棵树结点的度的最大值是结点D的度3，所以树的度也为3



结点的子树的根称为该结点的孩子（Child），相应地，该结点称为孩子的双亲（Parent），同一个双亲的孩子之间互称为兄弟（Sibling)。结点的祖先是从根到该结点所经分支上的所有结点。所以对于H来说，D，B，A都是它的祖先。反之，以某结点为根的子树中的任一结点都称为该结点的子孙。B的子孙有D,G,H,I，如图5所示。

三、结点的层次（Level)

从根开始定义起，根为第一层，根的孩子为第二层。其双亲在同一层的结点互为堂兄弟。显然在图6中D,E,F都是堂兄弟，而
G,H,I 与 J也是堂兄弟。树中结点的 最大层次称为树的深度（Depth)或高度，当前树的深度为4（注：也有一些书是定义为branches的个数，此时认为
深度为3）。



若将树中每个结点的各子树看成是从左到右有次序的(即不能互换)，则称该树为有序树(OrderedTree)；否则称为无序树(UnorderedTree)。注意：若不特别指明，一般讨论的树都是有序树。
森林(Forest)是m(m≥0)棵互不相交的树的集合。对树中每个结点而言，其子树的集合即为森林。对于图1的树而言，图2的两棵子树其实就可以理解为森林。树和森林的概念相近。删去一棵树的根，就得到一个森林；反之，加上一个结点作树根，森林就变为一棵树。
对比线性表与树的结构，它们有很大不同，如图7所示。

图

图概述

图(Graph)是一种比线性结构和树形结构都要复杂的数据结构。简单讲，图是由表示数据元素的的集合V和表示数据之间关系的集合E组成。其中，数据元素常称作顶点(vertex)，数据之间的关系常称作边(edge)。故图可记为G=<V,E>，其中V是顶点的有穷非空集合，E是边的集合。在图中顶点的前驱和后继是不设限制的，因此图描述的是一种网状关系。

无向图

若边是无序的或者说是无向的，则称此图是无向图。若无向图中有边(vi,vj)(无向图中边用圆括号表示)，则显然(vj,vi)和(vi,vj)是同一条边。

有向图

若边是有序的或者说是有向的，则称此图是有向图。若有向图中有边<vi,vj>(有向图中边用尖括号表示)，则显然<vj,vi>和<vi,vj>不是同一条边。有向图中的边也称为弧(arc)，对于弧<vi,vj>，vi是弧尾(边的起点)，vj是弧头(边的终点)。
示例图
无向图 G1=<V1,E1> V1={v0,v1,v2,v3,v4} E1={(v0,v1),(v0,v2),(v1,v3),(v2,v3),(v2,v4),(v3,v4)}
有向图 G2=<V2,E2> V2={v0,v1,v2,v3} E2={<v0,v1>,<v0,v2>,<v2,v0>,<v2,v3>,<v3,v0>}

图的存储

所谓的图的存储，主要是想从存储结构中表达各顶点之间的联系，也就是表现图中的边。因为顶点总是很好存储的，如最常见的一维数组存储边：

顶点

| v0 | v1 | v2 | v3 | v4 |

或者是

| A | B | C | D | E

邻接矩阵(adjacency matrix)和邻接表(adjacency list)是图的两种常见存储方式。
如上，无向图G1，对于顶点Vi和顶点Vj，若有边，则(Vi,Vj)=1，否则(Vi,Vj)=0。显然(Vi,Vi)=0，此时的邻接矩阵如下：

V0  V1  V2  V3  V4
V0  0   1   1   0   0
V1  1   0   0   1   0
V2  1   0   0   1   1
V3  0   1   1   0   1
V4  0   0   1   1   0

显然，由于是无向图，该矩阵是对称的。邻接矩阵所需的存储空间的大小与边数无关，而与顶点数有关。它所需的空间复杂度是O(n^2)，n是顶点数。
同样的，若是使用邻接表来存储无向图G1，邻接表如下：

邻接表实质就是链式存储。
对于有权图，在邻接矩阵中只需把1改为为相应的权值即可，在邻接表中顶点结构体则需添加成员表示权值。

常用概念

• 顶点的度(degree)：与顶点关联的边的数目，记为D(v)。特别的，在有向图中，把顶点v作为终点的弧的数目是入度(in degree)，记为ID(v)；把顶点v作为起点的弧的数目是出度(out degree)，记为OD(v)。显然，D(v)=ID(v)+OD(v)。
• 顶点v1和顶点v2若是有边相连的，则称它们是相邻的(adjacent)。
• 用n表示顶点数，e表示边数。则无向图中e是0,n(n-2)/2；有向图中e是[0,n(n-1)]。
• 边数较少的图称为稀疏图(sparse graph)，边数较多则称为稠密图(dense graph)。
• 完全图：任意两个顶点之间都有边相关联的是完全图。完全图中边数达到最大。细分为无向完全图和有向完全图。
• 有时边是带有权值的，这个权值可以表示从一个顶点到另一个顶点的距离、代价、耗费等。这样的图也称为带权图。
• 子图：设G=<V,E>是一个图，V1是V的子集，E1是E的子集，且E1中的边只与V1中的顶点有关，则称G1=<V1,E1>是G的的子图(subgraph)。
• 路径：在无向图中顶点序列：vi,vj,…,vk，且相邻两顶点之间是有边的，则这个序列构成一条路径。在有向图中，构成路径的不仅是要有边，而且边的方向正确：只能是起点到终点。
• 简单路径：路径中不存在重复顶点，则是简单路径(simple path)。
  环：在一条路径中，只有第一个顶点和最后一个顶点相同，这条路径就是环(cycle)或回路。
  路径长度：路径上边的数目。
• 无环图：没有环的图(acyclic graph)。在有向图中，那就是有向无环图。
• 在无向图中，若顶点vi和vj是有路径的，则称vi和vj是连通的(connected)。若图中任意两个顶点都是连通的，则称该图是连通图。
• 连通分量：无向图中的极大连通子图。(所谓的极大是指再加入任意一个顶点，则不连通)
  在有向图中，任意两个顶点之间都有一条有向的路径，则称该有向图是强连通图。
• 强连通分量：有向强连通的极大子图称为有向图的强连通分量或强连通分支。

概论看不懂没关系.后面会用更简单的方法介绍.听起来吓人那就对了

请问怎么设置在线的图片

public Drawable getDrawable(String source) {
                                Drawable drawable = BitmapUtil.LoadImageFromWebOperations(source);
                                drawable.setBounds(0, 0, about.getWidth() - about.getPaddingLeft() - about.getPaddingRight(), 400);
                                return drawable;
                            }

文章内锚点跳转不可用 。

[说明文字](#jump)
然后标记要跳转到什么位置即可：

<span id = "jump">跳转到这里：</span>

类似这样的锚点操作不可用

卡卡的，很贴心

被卡哭了

图文混排的时候图片能不能水平居中?

图文混排的时候图片能不能水平居中? 无序列表的点能不能一起居中?

自定义样式无法使用

我再style.xml增加了@style/Markdown.Light ，但是编译报错，信息如下：
Cannot resolve symbol 'markdownStyle'

##渲染了多余的文本.版本2.0.6

Apk打包过程概述

最近看了老罗分析android资源管理和apk打包流程的博客，参考其他一些资料，做了一下整理，脱离繁琐的打包细节和数据结构，从整体上概述了apk打包的整个流程。

流程概述：

1. 打包资源文件，生成R.java文件
2. 处理aidl文件，生成相应java 文件
3. 编译工程源代码，生成相应class 文件
4. 转换所有class文件，生成classes.dex文件
5. 打包生成apk
6. 对apk文件进行签名
7. 对签名后的apk文件进行对其处理

图如下:

打包过程使用的工具

(1)aapt
（Android Asset Package Tool）
Android资源打包工具
${ANDROID_SDK_HOME} /build-tools/
ANDROID_VERSION/aapt
frameworks\base\tools\aap\

(2)aidl（android interface definition language）Android接口描述语言，
将aidl转化为.Java文件的工具
${ANDROID_SDK_HOME}/build-tools/ANDROID_VERSION/aidl
frameworks\base\tools\aidl
javac Java Compiler
${JDK_HOME}/java

c或/usr/bin/javac

(3)dex
转化.class文件为Davik VM能识别的.dex文件${ANDROID_SDK_HOME}/build-tools/ANDROID_VERSION/dx

(4)apkbuilder
生成apk包
${ANDROID_SDK_HOME}/tools/apkbuildersdk\sdkmanager\libs\sdklib\src\com\android\sdklib\build\ApkBuilderMain.java

(5)jarsigner .jar文件的签名工具 ${JDK_HOME}/jarsigner或/usr/bin/jarsigner

(6)zipalign 字节码对齐工具 ${ANDROID_SDK_HOME}/tools/zipalign

第一步：打包资源文件，生成R.java文件。

【输入】Resource文件（就是工程中res中的文件）、Assets文件（相当于另外一种资源，这种资源Android系统并不像对res中的文件那样优化它）、AndroidManifest.xml文件（包名就是从这里读取的，因为生成R.java文件需要包名）、Android基础类库（Android.jar文件）
【工具】aapt工具
【输出】打包好的资源（bin目录中的resources.ap_文件）、R.java文件（gen目录中）
打包资源的工具aapt，大部分文本格式的XML资源文件会被编译成二进制格式的XML资源文件，除了assets和res/raw资源被原装不动地打包进APK之外，其它的资源都会被编译或者处理。 。
生成过程主要是调用了aapt源码目录下的Resource.cpp文件中的buildResource（）函数，该函数首先检查AndroidManifest.xml的合法性，然后对res目录下的资源子目录进行处理，处理的函数为makeFileResource（），处理的内容包括资源文件名的合法性检查，向资源表table添加条目等，处理完后调用compileResourceFile（）函数编译res与asserts目录下的资源并生成resources.arsc文件，compileResourceFile（）函数位于aapt源码目录的ResourceTable.cpp文件中，该函数最后会调用parseAndAddEntry（）函数生成R.java文件，完成资源编译后，接下来调用compileXmlfile()函数对res目录的子目录下的xml文件分别进行编译，这样处理过的xml文件就简单的被“加密”了，最后将所有的资源与编译生成的resorces.arsc文件以及“加密”过的AndroidManifest.xml文件打包压缩成resources.ap_文件（使用Ant工具命令行编译则会生成与build.xml中“project name”指定的属性同名的ap_文件）。
关于这一步更详细的流程可阅读http://blog.csdn.net/luoshengyang/article/details/8744683

第二步：处理aidl文件，生成相应的java文件。

【输入】源码文件、aidl文件、framework.aidl文件
【工具】aidl工具
【输出】对应的.java文件
对于没有使用到aidl的android工程，这一步可以跳过。aidl工具解析接口定义文件并生成相应的java代码供程序调用。

第三步：编译工程源代码，生成下相应的class文件。

【输入】源码文件（包括R.java和AIDL生成的.java文件）、库文件（.jar文件）
【工具】javac工具
【输出】.class文件
这一步调用了javac编译工程src目录下所有的java源文件，生成的class文件位于工程的bin\classes目录下，上图假定编译工程源代码时程序是基于android SDK开发的，实际开发过程中，也有可能会使用android NDK来编译native代码，因此，如果可能的话，这一步还需要使用android NDK编译C/C++代码，当然，编译C/C++代码的步骤也可以提前到第一步或第二步。

第四步：转换所有的class文件，生成classes.dex文件。

【输入】 .class文件（包括Aidl生成.class文件，R生成的.class文件，源文件生成的.class文件），库文件（.jar文件）
【工具】javac工具
【输出】.dex文件
前面多次提到，android系统dalvik虚拟机的可执行文件为dex格式，程序运行所需的classes.dex文件就是在这一步生成的，使用的工具为dx，dx工具主要的工作是将java字节码转换为dalvik字节码、压缩常量池、消除冗余信息等。

第五步：打包生成apk。

• 【输入】打包后的资源文件、打包后类文件（.dex文件）、libs文件（包括.so文件，当然很多工程都没有这样的文件，如果你不使用C/C++开发的话）
• 【工具】apkbuilder工具
• 【输出】未签名的.apk文件
  打包工具为apkbuilder，apkbuilder为一个脚本文件，实际调用的是android-sdk\tools\lib\sdklib.jar文件中的com.android.sdklib.build.ApkBuilderMain类。它的代码实现位于android系统源码的sdk\sdkmanager\libs\sdklib\src\com\android\sdklib\build\ApkBuilderMain.java文件，代码构建了一个ApkBuilder类，然后以包含resources.arsc的文件为基础生成apk文件，这个文件一般为ap_结尾，接着调用addSourceFolder()函数添加工程资源，addSourceFolder()会调用processFileForResource（）函数往apk文件中添加资源，处理的内容包括res目录与asserts目录中的文件，添加完资源后调用addResourceFromJar（）函数往apk文件中写入依赖库，接着调用addNativeLibraries()函数添加工程libs目录下的Native库（通过android NDK编译生成的so或bin文件），最后调用sealApk（）关闭apk文件。

第六步：对apk文件进行签名。

• 【输入】未签名的.apk文件
• 【工具】jarsigner
• 【输出】签名的.apk文件
  android的应用程序需要签名才能在android设备上安装，签名apk文件有两种情况：一种是在调试程序时进行签名，使用eclipse开发android程序时，在编译调试程序时会自己使用一个debug.keystore对apk进行签名；另一种是打包发布时对程序进行签名，这种情况下需要提供一个符合android开发文档中要求的签名文件。签名的方法也分两种：一种是使用jdk中提供的jarsigner工具签名；另一种是使用android源码中提供的signapk工具，它的代码位于android系统源码build\tools\signapk目录下。

第七步：对签名后的apk文件进行对齐处理。

• 【输入】签名后的.apk文件
• 【工具】zipalign工具
• 【输出】对齐后的.apk文件
  这一步需要使用的工具为zipalign，它位于android-sdk\tools目录，源码位于android系统源码的build\tools\zipalign目录，它的主要工作是将spk包进行对齐处理，使spk包中的所有资源文件距离文件起始偏移为4字节整数倍，这样通过内存映射访问apk文件时速度会更快，验证apk文件是否对齐过的工作由ZipAlign.cpp文件的verify()函数完成，处理对齐的工作则由process（）函数完成。

以一个具体项目中包含的具体文件为例作图如下：

添加gradle支持

解析字符很多的Markdown,直接被卡哭了，正则匹配用了20多秒

图片url带下划线“_”时，下划线会被去掉，导致图片下载地址有问题

地址：http://www.fotor.com/images2/features/photo_effects/e_bw.jpg
会被转换成http://www.fotor.com/images2/features/photoeffects/ebw.jpg

咦，肿么木有开源授权协议？

代码片段显示奔溃

加载代码片段有时候空格很大，有时候会奔溃 private int getTextInLineLenInRange(CharSequence text, int start, int end, int rs, int re, Paint paint) {
int e = rs;
if (rs > end) {
return end;
}
while (paint.measureText(text, start, e) < mWidth - PADDING * 2) {
e++;
if (e > end || e > re) {
break;
}
}
return e - 1;
} 这个方法会出现数组越界的异常奔溃，请问怎么弄

Stackoverflow文件如下.使用版本2.0.6

Android 调试桥(adb)是多种用途的工具，该工具可以帮助你你管理设备或模拟器 的状态。

可以通过下列几种方法加入adb:

• 在设备上运行shell命令
• 通过端口转发来管理模拟器或设备
• 从模拟器或设备上拷贝来或拷贝走文件
• 下面对adb进行了介绍并描述了常见的使用.

Contents

1. 概要
2. 发出adb命令
3. 查询模拟器/设备实例
4. 给特定的模拟器/设备实例发送命令
5. 安装软件
6. 转发端口
7. 从模拟器/设备中拷入或拷出文件
8. Adb命令列表
9. 启动shell命令
   1. 通过远程shell端运行sqllite3连接数据库
   2. UI/软件 试验程序 Monkey
   3. 其它的shell命令
10. 启用logcat日志
    使用logcat命令
    1. 过滤日志输出
    2. 控制日志输出格式
       3 查看可用日志缓冲区
    3. 查看stdout 和stderr
    4. Logcat命令列表
11. 停止adb服务

概要

Android 调试系统是一个面对客户服务系统，包括三个组成部分:

一个在你用于开发程序的电脑上运行的客户端。你可以通过shell端使用adb命令启动客户端。 其他Android工具比如说ADT插件和DDMS同样可以产生adb客户端.
在你用于发的机器上作为后台进程运行的服务器。该服务器负责管理客户端与运行于模拟器或设备上的adb守护程序(daemon)之间的通信。.
一个以后台进程的形式运行于模拟器或设备上的守护程序(daemon)。.
当你启动一个adb客户端，客户端首先确认是否已有一个adb服务进程在运行。如果没有，则启动服务进程。当服务器运行， adb服务器就会绑定本地的TCP端口5037并监听adb客户端发来的命令，—所有的adb客户端都是用端口 5037与adb服务器对话的.

接着服务器将所有运行中的模拟器或设备实例建立连接。它通过扫描所有5555到5585范围内的奇数端口来定位所有的模拟器或设备。一旦服务器找到 了adb守护程序，它将建立一个到该端口的连接。请注意任何模拟器或设备实例会取得两个连续的端口——一个偶数端口用来相应控制台的连接，和一个奇数端口 用来响应adb连接。比如说:

模拟器1，控制台：端口5554
模拟器1，Adb端口5555
控制台：端口 5556
Adb端口5557...

如上所示，模拟器实例通过5555端口连接adb，就如同使用5554端口连接控制台一样.

一旦服务器与所有模拟器实例建立连接，就可以使用adb命令控制和访问该实例。因为服务器管理模拟器/设备实例的连接，和控制处理从来自多个adb客户端来的命令，你可以通过任何客户端(或脚本)来控制任何模拟器或设备实例.

以下的部分描述通过命令使用adb和管理模拟器/设备的状态。要注意的是如果你用，装有ADT插件的Eclipse开发Android程序，你就不 需要通过命令行使用adb。ADT插件已经透明的把adb集成到Eclipse中了，当然，如果必要的话你也可以仍然直接使用adb，比如说调试.

发出adb命令

发出Android命令： 你可以在你的开发机上的命令行或脚本上发布Android命令，使用方法:

adb [-d|-e|-s ]
当你发出一个命令，系统启用Android客户端。客户端并不与模拟器实例相关，所以如果双服务器/设备是运行中的，你需要用 -d 选项去为应被控制的命令确定目标实例。关于使用这个选项的更多信息，可以查看模拟器/设备实例术语控制命令 .

查询模拟器/设备实例
在发布adb命令之前，有必要知道什么样的模拟器/设备实例与adb服务器是相连的。可以通过使用devices 命令来得到一系列相关联的模拟器/设备:

adb devices

• 作为回应，adb为每个实例都制定了相应的状态信息:
• 序列号——由adb创建的一个字符串，这个字符串通过自己的控制端口- 唯一地识别一个模拟器/设备实例。下面是一个序列号的例子： emulator-5554
  实例的连接状态有三种状态:
  • offline — 此实例没有与adb相连接或者无法响应.
  • device — 此实例正与adb服务器连接。注意这个状态并不能百分之百地表示在运行和操作Android系统，因此这个实例是当系统正在运行的时候与adb连接的。然而，在系统启动之后，就是一个模拟器/设备状态的正常运行状态了.
    每个实例的输出都有如下固定的格式:

[serialNumber] [state]
下面是一个展示devices 命令和输出的例子 :

$ adb devicesList of devices attached emulator-5554  deviceemulator-5556  deviceemulator-5558  device
如果当前没有模拟器/设备运行，adb则返回 no device .

给特定的模拟器/设备实例发送命令

如果有多个模拟器/设备实例在运行，在发布adb命令时需要指定一个目标实例。 这样做，请使用-s 选项的命令。在使用的-s 选项是

adb -s
如上所示，给一个命令指定了目标实例，这个目标实例使用由adb分配的序列号。你可以使用 devices 命令来获得运行着的模拟器/设备实例的序列号

示例如下:

adb -s emulator-5556 install helloWorld.apk

注意这点，如果没有指定一个目标模拟器/设备实例就执行 -s 这个命令的话，adb会产生一个错误.

安装软件

你可以使用adb从你的开发电脑上复制一个应用程序，并且将其安装在一个模拟器/设备实例。像这样做，使用install 命令。这个install 命令要求你必须指定你所要安装的.apk文件的路径:

adb install <path_to_apk>

为了获取更多的关于怎样创建一个可以安装在模拟器/设备实例上的.apk文件的信息，可参照Android Asset Packaging Tool (aapt).

要注意的是，如果你正在使用Eclipse IDE并且已经安装过ADT插件，那么就不需要直接使用adb（或者aapt）去安装模拟器/设备上的应用程序。否则，ADT插件代你全权处理应用程序的打包和安装.

转发端口

可以使用 forward 命令进行任意端口的转发——一个模拟器/设备实例的某一特定主机端口向另一不同端口的转发请求。下面演示了如何建立从主机端口6100到模拟器/设备端口7100的转发。

adb forward tcp:6100 tcp:7100

同样地，可以使用adb来建立命名为抽象的UNIX域套接口，上述过程如下所示:

adb forward tcp:6100 local:logd 

从模拟器/设备中拷入或拷出文件

可以使用adbpull ,push 命令将文件复制到一个模拟器/设备实例的数据文件或是从数据文件中复制。install 命令只将一个.apk文件复制到一个特定的位置，与其不同的是，pull 和 push 命令可令你复制任意的目录和文件到一个模拟器/设备实例的任何位置。

从模拟器或者设备中复制文件或目录，使用(如下命):

adb pull <remote> <local>

将文件或目录复制到模拟器或者设备，使用（如下命令）

adb push <local> <remote>

在这些命令中， 和 分别指通向自己的发展机（本地）和模拟器/设备实例（远程）上的目标文件/目录的路径

下面是一个例子：:

adb push foo.txt /sdcard/foo.txt

Adb命令列表

下列表格列出了adb支持的所有命令,并对它们的意义和使用方法做了说明.

Category    Command Description Comments
Options -d  仅仅通过USB接口来管理abd.  如果不只是用USB接口来管理则返回错误.
-e  仅仅通过模拟器实例来管理adb.    如果不是仅仅通过模拟器实例管理则返回错误.
-s <serialNumber>   通过模拟器/设备的允许的命令号码来发送命令来管理adb (比如: "emulator-5556").    如果没有指定号码，则会报错.
General devices 查看所有连接模拟器/设备的设施的清单.   查看 Querying for Emulator/Device Instances获取更多相关信息.
help    查看adb所支持的所有命令。.    
version 查看adb的版本序列号.     
Debug   logcat [<option>] [<filter-specs>]  将日志数据输出到屏幕上.   
bugreport   查看bug的报告，如dumpsys ,dumpstate ,和logcat 信息。  
jdwp    查看指定的设施的可用的JDWP信息.    可以用 forward jdwp:<pid> 端口映射信息来连接指定的JDWP进程.例如： 
adb forward tcp:8000 jdwp:472 
jdb -attach localhost:8000
Data    install <path-to-apk>   安装Android为（可以模拟器/设施的数据文件.apk指定完整的路径）.    
pull <remote> <local>   将指定的文件从模拟器/设施的拷贝到电脑上.  
push <local> <remote>   将指定的文件从电脑上拷贝到模拟器/设备中.  
Ports and Networking    forward <local> <remote>    用本地指定的端口通过socket方法远程连接模拟器/设施  端口需要描述下列信息:
tcp:<portnum>
local:<UNIX domain socket name>
dev:<character device name>
jdwp:<pid>
ppp <tty> [parm]... 通过USB运行ppp：
<tty> — the tty for PPP stream. For exampledev:/dev/omap_csmi_ttyl.
[parm]...  &mdash zero or more PPP/PPPD options, such as defaultroute ,local , notty , etc.
需要提醒你的不能自动启动PDP连接.

Scripting   get-serialno    查看adb实例的序列号.    查看 Querying for Emulator/Device Instances可以获得更多信息.
get-state   查看模拟器/设施的当前状态.
wait-for-device 如果设备不联机就不让执行,--也就是实例状态是 device 时. 你可以提前把命令转载在adb的命令器中,在命令器中的命令在模拟器/设备连接之前是不会执行其它命令的. 示例如下:
adb wait-for-device shell getprop
需要提醒的是这些命令在所有的系统启动启动起来之前是不会启动adb的 所以在所有的系统启动起来之前你也不能执行其它的命令. 比如：运用install 的时候就需要Android包，这些包只有系统完全启动。例如：
adb wait-for-device install <app>.apk
上面的命令只有连接上了模拟器/设备连接上了adb服务才会被执行，而在Android系统完全启动前执行就会有错误发生.
Server  start-server    选择服务是否启动adb服务进程.     
kill-server 终止adb服务进程.   
Shell   shell   通过远程shell命令来控制模拟器/设备实例. 查看 获取更多信息 for more information.
shell [<shellCommand>]  连接模拟器/设施执行shell命令，执行完毕后退出远程shell端l.

启动shell命令

Adb 提供了shell端，通过shell端你可以在模拟器或设备上运行各种命令。这些命令以2进制的形式保存在本地的模拟器或设备的文件系统中:

/system/bin/...

不管你是否完全进入到模拟器/设备的adb远程shell端，你都能 shell 命令来执行命令.

当没有完全进入到远程shell的时候，这样使用shell 命令来执行一条命令:

adb [-d|-e|-s {<serialNumber>}] shell <shellCommand>

在模拟器/设备中不用远程shell端时，这样使用shell 命 :

adb [-d|-e|-s {<serialNumber>}] shell

通过操作CTRL+D 或exit 就可以退出shell远程连接.

下面一些就将告诉你更多的关于shell命令的知识.

通过远程shell端运行sqllite3连接数据库

通过adb远程shell端，你可以通过Android软sqlite3 命令程序来管理数据库。sqlite3 工具包含了许多使用命令，比如：.dump 显示表的内容，.schema 可以显示出已经存在的表空间的SQL CREATE结果集。Sqlite3还允许你远程执行sql命令.

通过sqlite3 , 按照前几节的方法登陆模拟器的远程shell端，然后启动工具就可以使用sqlite3 命令。当sqlite3 启动以后，你还可以指定你想查看的数据库的完整路径。模拟器/设备实例会在文件夹中保存SQLite3数据库. /data/data/<package_name>/databases/ .

示例如下:

$ adb -s emulator-5554 shell# sqlite3 /data/data/com.example.google.rss.rssexample/databases/rssitems.dbSQLite version 3.3.12Enter ".help" for instructions.... enter commands, then quit...sqlite> .exit 

当你启动sqlite3的时候，你就可以通过shell端发送 sqlite3 ,命令了。用exit 或 CTRL+D 退出adb远程shell端.

UI/软件 试验程序 Monkey

当Monkey程序在模拟器或设备运行的时候，如果用户出发了比如点击，触摸，手势或一些系统级别的事件的时候，它就会产生随机脉冲，所以可以用Monkey用随机重复的方法去负荷测试你开发的软件.

最简单的方法就是用用下面的命令来使用Monkey，这个命令将会启动你的软件并且触发500个事件.

$ adb shell monkey -v -p your.package.name 500

更多的关于命令Monkey的命令的信息，可以查看UI/Application Exerciser Monkey documentation page.

文档页面

其它的shell命令

下面的表格列出了一些adbshell命令，如果需要全部的命令和程序，可以启动模拟器实例并且用adb -help 命令 .

adb shell ls /system/bin

对大部门命令来说，help都是可用的.

Shell Command   Description Comments
dumpsys 清除屏幕中的系统数据n.    Dalvik Debug Monitor Service (DDMS)工具提供了完整的调试、.
dumpstate   清除一个文件的状态.
logcat [<option>]... [<filter-spec>]... 启动信息日志并且但因输出到屏幕上.
dmesg   输出主要的调试信息到屏幕上.
start   启动或重启一个模拟器/设备实例.     
stop    关闭一个模拟器/设备实例.  

强制停止某个app

adb shell am force-stop [packageName]

启用logcat日志
Android日志系统提供了记录和查看系统调试信息的功能。日志都是从各种软件和一些系统的缓冲区中记录下来的，缓冲区可以通过 logcat 命令来查看和使用.

使用logcat命令

你可以用 logcat 命令来查看系统日志缓冲区的内容:

[adb] logcat [<option>] ... [<filter-spec>] ...

请查看Listing of logcat Command Options ，它对logcat命令有详细的描述 .

你也可以在你的电脑或运行在模拟器/设备上的远程adb shell端来使用logcat 命令，也可以在你的电脑上查看日志输出。

$ adb logcat

你也这样使用：

# logcat

过滤日志输出

每一个输出的Android日志信息都有一个标签和它的优先级.

日志的标签是系统部件原始信息的一个简要的标志。（比如：“View”就是查看系统的标签）.
优先级有下列集中，是按照从低到高顺利排列的:

V — Verbose (lowest priority)
D — Debug
I — Info
W — Warning
E — Error
F — Fatal
S — Silent (highest priority, on which nothing is ever printed)

在运行logcat的时候在前两列的信息中你就可以看到 logcat 的标签列表和优先级别,它是这样标出的:/ .

下面是一个logcat输出的例子,它的优先级就似乎I,标签就是ActivityManage:

I/ActivityManager(  585): Starting activity: Intent { action=android.intent.action...}

为了让日志输出能体现管理的级别,你还可以用过滤器来控制日志输出,过滤器可以帮助你描述系统的标签等级.

过滤器语句按照下面的格式描tag:priority ... , tag 表示是标签, priority 是表示标签的报告的最低等级. 从上面的tag的中可以得到日志的优先级. 你可以在过滤器中多次写tag:priority .

这些说明都只到空白结束。下面有一个列子，例子表示支持所有的日志信息，除了那些标签为”ActivityManager”和优先级为”Info”以上的和标签为” MyApp”和优先级为” Debug”以上的。 小等级,优先权报告为tag.

adb logcat ActivityManager:I MyApp:D *:S

上面表达式的最后的元素 *:S ,，是设置所有的标签为"silent"，所有日志只显示有"View" and "MyApp"的，用 *:S 的另一个用处是 能够确保日志输出的时候是按照过滤器的说明限制的，也让过滤器也作为一项输出到日志中.

下面的过滤语句指显示优先级为warning或更高的日志信息:

adb logcat *:W

如果你电脑上运行logcat ，相比在远程adbshell端，你还可以为环境变量ANDROID_LOG_TAGS :输入一个参数来设置默认的过滤

export ANDROID_LOG_TAGS="ActivityManager:I MyApp:D *:S"

需要注意的是ANDROID_LOG_TAGS 过滤器如果通过远程shell运行logcat 或用adb shell logcat 来运行模拟器/设备不能输出日志.

控制日志输出格式

日志信息包括了许多元数据域包括标签和优先级。可以修改日志的输出格式，所以可以显示出特定的元数据域。可以通过 -v 选项得到格式化输出日志的相关信息.

brief — Display priority/tag and PID of originating process (the default format).
process — Display PID only.
tag — Display the priority/tag only.
thread — Display process:thread and priority/tag only.
raw — Display the raw log message, with no other metadata fields.
time — Display the date, invocation time, priority/tag, and PID of the originating process.
long — Display all metadata fields and separate messages with a blank lines.

当启动了logcat ，你可以通过-v 选项来指定输出格式:

[adb] logcat [-v <format>]

下面是用 thread 来产生的日志格式:

adb logcat -v thread

需要注意的是你只能-v 选项来规定输出格式 option.

查看可用日志缓冲区

Android日志系统有循环缓冲区，并不是所有的日志系统都有默认循环缓冲区。为了得到日志信息，你需要通过-b 选项来启动logcat 。如果要使用循环缓冲区，你需要查看剩余的循环缓冲期:

radio — 查看缓冲区的相关的信息.
events — 查看和事件相关的的缓冲区.
main — 查看主要的日志缓冲区
-b 选项使用方法:

[adb] logcat [-b <buffer>]

下面的例子表示怎么查看日志缓冲区包含radio 和 telephony信息:

adb logcat -b radio

查看stdout 和stderr

在默认状态下，Android系统有stdout 和 stderr (System.out 和System.err )输出到/dev/null ，在运行Dalvik VM的进程中，有一个系统可以备份日志文件。在这种情况下，系统会用stdout 和stderr 和优先级 I.来记录日志信息

通过这种方法指定输出的路径，停止运行的模拟器/设备，然后通过用 setprop 命令远程输入日志

$ adb shell stop$ adb shell setprop log.redirect-stdio true$ adb shell start

系统直到你关闭模拟器/设备前设置会一直保留，可以通过添加/data/local.prop 可以使用模拟器/设备上的默

Logcat命令列表

-b <buffer> 加载一个可使用的日志缓冲区供查看，比如event 和radio . 默认值是main 。具体查看Viewing Alternative Log Buffers.
-c  清楚屏幕上的日志.
-d  输出日志到屏幕上.
-f <filename>   指定输出日志信息的<filename> ，默认是stdout .
-g  输出指定的日志缓冲区，输出后退出.
-n <count>  设置日志的最大数目<count> .，默认值是4，需要和 -r 选项一起使用。
-r <kbytes> 每<kbytes> 时输出日志，默认值为16，需要和-f 选项一起使用.
-s  设置默认的过滤级别为silent.
-v <format> 设置日志输入格式，默认的是brief 格式，要知道更多的支持的格式，参看Controlling Log Output Format .

Stopping the adb Server

在某些情况下，你可能需要终止Android 调试系统的运行,然后再重新启动它。 例如,如果Android 调试系统不响应命令，你可以先终止服务器然后再重启，这样就可能解决这个问题.
用kill-server 可以终止adb server。你可以用adb发出的任何命令来重新启动服务器.

已解决！打扰了！