Android安卓开发 - 开发基础（二）

妖狐艹你老母 2024-04-29 19:07 75阅读 0赞

所有的开发案例实战以及基础知识都在我的Gitee里面： [Android: Android Studio创建并编译App工程的过程和步骤，首先叙述了如何通过Android Studio 创建新的App项目，接着描述了如何导入已有的App工程（包括导入项目和导入模块两种方式），然后阐述了如何手工编译App工程。 包含了所有Android 开发案例demo，从入门到实战 (gitee.com)][Android_ Android Studio_App_Android Studio _App_App_App_ _Android _demo_ _gitee.com]

### App的工程结构  ###

本节介绍App工程的基本结构及其常用配置，首先描述项目和模块的区别，以及工程内部各目录与配置

文件的用途说明；其次阐述两种级别的编译配置文件build.gradle，以及它们内部的配置信息说明；再次讲述运行配置文件AndroidManifest.xml的节点信息及其属性说明。

#### 2.2.1　App工程目录结构  ####

App工程分为两个层次，第一个层次是项目，依次选择菜单File→New→New Project即可创建新项目。

另一个层次是模块，模块依附于项目，每个项目至少有一个模块，也能拥有多个模块，依次选择菜单

File→New→New Module即可在当前项目创建新模块。一般所言的“编译运行App”，指的是运行某个模块，而非运行某个项目，因为模块才对应实际的App。单击Android Studio左上角竖排的Project标签，可见App工程的项目结构如图2-12所示。

![f42e581f215946e6b143ea710d6f1c25.jpeg][]

该项目下面有两个分类：一个是app（代表app模块）；另一个是Gradle Scripts。其中，app下面又有3个子目录，其功能说明如下：

1.  manifests子目录，下面只有一个XML文件，即AndroidManifest.xml，它是App的运行配置文件。
2.  java子目录，下面有3个com.example.myapp包，其中第一个包存放当前模块的Java源代码，后面两个包存放测试用的Java代码。 
3.  res子目录，存放当前模块的资源文件。res下面又有4个子目录：

drawable目录存放图形描述文件与图片文件。

layout目录存放App页面的布局文件。

mipmap目录存放App的启动图标。

values目录存放一些常量定义文件，例如字符串常量strings.xml、像素常量dimens.xml、颜色常量colors.xml、样式风格定义styles.xml等。

Gradle Scripts下面主要是工程的编译配置文件，主要有：

1.  build.gradle，该文件分为项目级与模块级两种，用于描述App工程的编译规则。 
2.  proguard-rules.pro，该文件用于描述Java代码的混淆规则。 
3.  gradle.properties，该文件用于配置编译工程的命令行参数，一般无须改动。 
4.  settings.gradle，该文件配置了需要编译哪些模块。初始内容为include ':app'，表示只编译app模块。
5.  local.properties，项目的本地配置文件，它在工程编译时自动生成，用于描述开发者电脑的环境配置，包括SDK的本地路径、NDK的本地路径等

#### 2.2.2　编译配置文件build.gradle  ####

新创建的App项目默认有两个build.gradle，一个是Project项目级别的build.gradle；另一个是Module 模块级别的build.gradle。

项目级别的build.gradle指定了当前项目的总体编译规则，打开该文件在buildscript下面找到

repositories和dependencies两个节点，其中repositories节点用于设置Android Studio插件的网络仓

库地址，而dependencies节点用于设置gradle插件的版本号。由于官方的谷歌仓库位于国外，下载速度相对较慢，因此可在repositories节点添加阿里云的仓库地址，方便国内开发者下载相关插件。修改之后的buildscript节点内容如下所示：

![66265e03050744ad82fc2d214d20c1d3.png][]

模块级别的build.gradle对应于具体模块，每个模块都有自己的build.gradle，它指定了当前模块的详细编译规则。build.gradle补充文字注释，方便读者更好地理解每个参数的用途。

![9bb39096ea854ba18efc92cb2e745426.png][]

![34965df8a1b54fdab50f0fb4bac5c019.png][]

为啥这两种编译配置文件的扩展名都是Gradle呢？这是因为它们采用了Gradle工具完成编译构建操作。

Gradle工具的版本配置在gradle\\wrapper\\gradle-wrapper.properties，也可以依次选择菜单

File→Project Structure→Project，在弹出的设置页面中修改Gradle Version。注意每个版本的Android Studio都有对应的Gradle版本，只有二者的版本正确对应，App工程才能成功编译。比如Android

[Studio 4.1][][对应的][Studio 4.1][Gradle][Studio 4.1][版本为][Studio 4.1][6.5][Studio 4.1][，更多的版本对应关系见][Studio 4.1]

#### 2.2.3　运行配置文件AndroidManifest.xml  ####

AndroidManifest.xml指定了App的运行配置信息，它是一个XML描述文件，初始内容如下所示：

![a4e064c488f149ad8e89dc0988634dec.png][]

可见AndroidManifest.xml的根节点为manifest，它的package属性指定了该App的包名。manifest下面有个application节点，它的各属性说明如下：

android:allowBackup，是否允许应用备份。允许用户备份系统应用和第三方应用的apk安装包和应用数据，以便在刷机或者数据丢失后恢复应用，用户即可通过adb backup和adb restore来进行对应用数据的备份和恢复。为true表示允许，为false则表示不允许。

android:icon，指定App在手机屏幕上显示的图标。 android:label，指定App在手机屏幕上显示的名称。

android:roundIcon，指定App的圆角图标。

android:supportsRtl，是否支持阿拉伯语／波斯语这种从右往左的文字排列顺序。为true表示支持，为false则表示不支持。

android:theme，指定App的显示风格。

注意到application下面还有个activity节点，它是活动页面的注册声明，只有在AndroidManifest.xml中正确配置了activity节点，才能在运行时访问对应的活动页面。初始配置的MainActivity正是App的默认主页，之所以说该页面是App主页，是因为它的activity节点内部还配置了以下的过滤信息：

<intent-filter>
                    <action android:name="android.intent.action.MAIN" />
    
                    <category android:name="android.intent.category.LAUNCHER" />
                </intent-filter>

其中action节点设置的android.intent.action.MAIN表示该页面是App的入口页面，启动App时会 先打开该页面。而category节点设置的android.intent.category.LAUNCHER决定了是否在手机屏幕上显示

App图标，如果同时有两个activity节点内部都设置了android.intent.category.LAUNCHER，那么桌面就会显示两个App图标。以上的两种节点规则可能一开始不太好理解，读者只需记住默认主页必须同时配置这两种过滤规则即可。

### 2.3　App的设计规范  ###

本节介绍了App工程的源码设计规范，首先App将看得见的界面设计与看不见的代码逻辑区分开，然后利用XML标记描绘应用界面，同时使用Java代码书写程序逻辑，从而形成App前后端分离的设计规约，有利于提高App集成的灵活性。

#### 2.3.1　界面设计与代码逻辑  ####

手机的功能越来越强大，某种意义上相当于微型电脑，比如打开一个电商App，仿佛是在电脑上浏览网站。网站分为用户看得到的网页，以及用户看不到的Web后台；App也分为用户看得到的界面，以及用户看不到的App后台。虽然Android允许使用Java代码描绘界面，但不提倡这么做，推荐的做法是将界面设计从Java代码剥离出来，通过单独的XML文件定义界面布局，就像网站使用HTML文件定义网页那样。

直观地看，网站的前后端分离设计如图2-13所示，App的前后端分离设计如图2-14所示。

![a68c19547fee4a0abd999a7a5c1e3d4a.png][]

1.  使用XML文件描述App界面，可以很方便地在Android Studio上预览界面效果。比如新创建的App 项目，默认首页布局为activity\_main.xml，单击界面右上角的Design按钮，即可看到如图2-15所示的预览界面。

如果XML文件修改了Hello World的文字内容，立刻就能在预览区域观看 新界面。倘若使用Java代码描绘界面，那么必须运行App才能看到App界面，无疑费时许多。

1.  一个界面布局可以被多处代码复用，比如看图界面，既能通过商城购物代码浏览商品图片，也能通过商品评价代码浏览买家晒单。
2.  反过来，一段Java代码也可能适配多个界面布局，比如手机有竖屏与横屏两种模式，默认情况App

采用同一套布局，然而在竖屏时很紧凑的界面布局（见图2-16），切换到横屏往往变得松垮乃至变形

（见图2-17）。

![62c9afa9f0de44a4817b7ed3e3bd96b3.jpeg][]

图2-15　XML文件的预览界面

![a56f5fa85c9e4e04903b8b0f5e870f3c.jpeg][]

图2-16　竖屏时候的界面布局

![86984f29e54d4f509f596b158e3bb2c1.jpeg][]

图2-17　横屏时候的界面布局

鉴于竖屏与横屏遵照一样的业务逻辑，仅仅是屏幕方向不同，若要调整的话，只需分别给出竖屏时候的界面布局，以及横屏时候的界面布局。因为用户多数习惯竖屏浏览，所以res/layout目录下放置的XML

文件默认为竖屏规格，另外在res下面新建名为layout-land的目录，用来存放横屏规格的XML文件。

land是landscape的缩写，意思是横向，Android把layout-land作为横屏XML的专用布局目录。然后在 layout-land目录创建与原XML同名的XML文件，并重新编排界面控件的展示方位，调整后的横屏界面如图2-18所示，从而有效适配了屏幕的水平方向。

![9f1159f77b864e6c8d250b3ae02da01c.jpeg][]

图2-18　采用另一个XML文件的横屏布局

总的来说，界面设计与代码逻辑分离的好处多多，后续的例程都由XML布局与Java代码两部分组成。

#### 2.3.2　利用XML标记描绘应用界面  ####

在前面“2.1.2　App的开发语言”末尾，给出了安卓控件的XML定义例子，如下所示：

![5b99899569cd4b3d955f09157e0d1645.png][]

注意到TextView标签以“<”开头，以“/>”结尾，为何尾巴多了个斜杆呢？要是没有斜杆，以左右尖括号包裹标签名称，岂不更好？其实这是XML的标记规范，凡是XML标签都由标签头与标签尾组成，标签头以左右尖括号包裹标签名称，形如“”；标签尾在左尖括号后面插入斜杆，以此同标签头区分开，形如“”。标签头允许在标签名称后面添加各种属性取值，而标签尾不允许添加任何属性，因此上述TextView标签的完整XML定义是下面这样的：

![ef36035794ce428e82caabd5e7bd5097.png][]

考虑到TextView仅仅是个文本视图，其标签头和标签尾之间不会插入其他标记，所以合并它的标签头和标签尾，也就是让TextView标签以“/>”结尾，表示该标签到此为止。

然而不是所有情况都能采取简化写法，简写只适用于TextView控件这种末梢节点。好比一棵大树，大树先有树干，树干分岔出树枝，一些大树枝又分出小树枝，树枝再长出末端的树叶。一个界面也是先有根节点（相当于树干），根节点下面挂着若干布局节点（相当于树枝），布局节点下面再挂着控件节点

（相当于树叶）。因为树叶已经是末梢了，不会再包含其他节点，所以末梢节点允许采用“/>”这种简写方式。

譬如下面是个XML文件的布局内容，里面包含了根节点、布局节点，以及控件节点：

![75d8f6ddeebc42d7a8c1a892c4a80fcf.png][]

上面的XML内容， 外层的LinearLayout标签为该界面的根节点，中间的LinearLayout标签为布局节点， 内层的TextView为控件节点。由于根节点和布局节点都存在下级节点，因此它们要有配对的标签头与标签尾，才能将下级节点包裹起来。根节点其实是特殊的布局节点，它的标签名称可以跟布局节点一样，区别之处在于下列两点：

1.  每个界面只有一个根节点，却可能有多个布局节点，也可能没有中间的布局节点，此时所有控件节点都挂在根节点下面。
2.  根节点必须配备“xmlns:android="[http://schemas.android.com/apk/res/android][http_schemas.android.com_apk_res_android]["][http_schemas.android.com_apk_res_android]”，表示指定

XML内部的命名空间，有了这个命名空间，Android Studio会自动检查各节点的属性名称是否合法，如果不合法就提示报错。至于布局节点就不能再指定命名空间了。

有了根节点、布局节点、控件节点之后，XML内容即可表达丰富多彩的界面布局，因为每个界面都能划分为若干豆腐块，每个豆腐块再细分为若干控件罢了。三种节点之外，尚有“”这类注释标记，它的作用是包裹注释性质的说明文字，方便其他开发者理解此处的XML含义。

#### 2.3.3　使用Java代码书写程序逻辑  ####

在XML文件中定义界面布局，已经明确是可行的了，然而这只是静态界面，倘若要求在App运行时修改文字内容，该当如何是好？倘若是动态变更网页内容，还能在HTML文件中嵌入JavaScript代码，由js片段操作Web控件。但Android的XML文件仅仅是布局标记，不能再嵌入其他语言的代码了，也就是说，只靠XML文件自身无法动态刷新某个控件。

XML固然表达不了复杂的业务逻辑，这副重担就得交给App后台的Java代码了。Android Studio每次创

建新项目，除了生成默认的首页布局activity\_main.xml之外，还会生成与其对应的代码文件

MainActivity.java。赶紧打开MainActivity.java，看看里面有什么内容，该Java文件中MainActivity类的内容如下所示：

![72049f87c2d54163bb0bbd3d92b5c2cd.png][]

可见MainActivity.java的代码内容很简单，只有一个MainActivity类，该类下面只有一个onCreate方

法。注意onCreate内部的setContentView方法直接引用了布局文件的名字activity\_main，该方法的意思是往当前活动界面填充activity\_main.xml的布局内容。现在准备在这里改动，把文字内容改成中文。

首先打开activity\_main.xml，在TextView节点下方补充一行android:id="@+id/tv\_hello"，表示给它起个名字编号；然后回到MainActivity.java，在setContentView方法下面补充几行代码，具体如下：

![57bd44b3ed0649e09ad7680ee19ad693.png][]

新增的两行代码主要做了这些事情：先调用findViewById方法，从布局文件中取出名为tv\_hello的

TextView控件；再调用控件对象的setText方法，为其设置新的文字内容。

代码补充完毕，重新运行测试App，发现应用界面变成了如图2-19所示的样子。

![65f9e9c3bd2d41a3b1991f125719e20e.png][]

[Android_ Android Studio_App_Android Studio _App_App_App_ _Android _demo_ _gitee.com]: https://gitee.com/zhousir03/android
[f42e581f215946e6b143ea710d6f1c25.jpeg]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/29/9acf41ddf98f4019971939cff28784b7.jpeg
[66265e03050744ad82fc2d214d20c1d3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/29/5938ad99302b47c7922aba21e940ccba.png
[9bb39096ea854ba18efc92cb2e745426.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/29/97de41ebb431400c907cddde2eed7a4c.png
[34965df8a1b54fdab50f0fb4bac5c019.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/29/aae1b9b204264df3b30d8f20051a1819.png
[Studio 4.1]: https://developer.android.google.cn/studio/releases/gradle-plugin#updating-plugin
[a4e064c488f149ad8e89dc0988634dec.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/29/db764c8c777a46e9a56578a4602bbdde.png
[a68c19547fee4a0abd999a7a5c1e3d4a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/29/e565cf8e8352469999fb7e81d232f167.png
[62c9afa9f0de44a4817b7ed3e3bd96b3.jpeg]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/29/b17a6614dc634df98798d6eabda6de23.jpeg
[a56f5fa85c9e4e04903b8b0f5e870f3c.jpeg]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/29/1b79ad2e41f84caaae7000a935c9bb7e.jpeg
[86984f29e54d4f509f596b158e3bb2c1.jpeg]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/29/6be2115281a346f7a1364ab7a7eb12e7.jpeg
[9f1159f77b864e6c8d250b3ae02da01c.jpeg]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/29/3a2f675aa9fb4bf2907ed304d2fbe38d.jpeg
[5b99899569cd4b3d955f09157e0d1645.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/29/3e674d67e0d446eb98f1c1044488e905.png
[ef36035794ce428e82caabd5e7bd5097.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/29/a6b22206aa9f4ab49c99aa921e5c9f4a.png
[75d8f6ddeebc42d7a8c1a892c4a80fcf.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/29/1bd803ba9bc145428d522f9ea5ddfb17.png
[http_schemas.android.com_apk_res_android]: http://schemas.android.com/apk/res/android
[72049f87c2d54163bb0bbd3d92b5c2cd.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/29/cf08535f181642dbaf119fb059576722.png
[57bd44b3ed0649e09ad7680ee19ad693.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/29/adf5553a09c140d7bcbeedede34c0158.png
[65f9e9c3bd2d41a3b1991f125719e20e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/29/07c6256cc7f3419ba2b613b89164569f.png