火山安卓新手入门教程_火山软件开发平台

## 火山安卓平台新手入门教程

作者：创世魂

● 教程说明

本篇教程共分为五个部分：

第一：安卓项目建立和程序编写。

第二：调试程序

第三：编译发布版安卓程序。

第四：学习资源。

第五：常见问题。

## 一、安卓项目建立和程序编写

#### ● 通过一个具体的火山程序来演示

1、打开火山程序。

> 选择“文件->新建->项目”，也可以使用快捷键“Ctrl+Shift+N”。

> 也可以点击“欢迎页”中的“新建项目”。

2、左侧选择“空白安卓程序”，右侧选择“空窗口”。

> 依次填写“项目名称”，“所处位置”和“解决方案名称”。

> 最后点击“确定”即可。

3、最后会在“所处位置”创建以下文件和目录。

> （1）其中“test.vsln”文件是解决方案主文件，打开一个火山项目都是通过此文件来打开。

> （2）“test”是当前解决方案中的其中一个项目，火山的解决方案可以建立多个项目进行同时管理，每个项目都可以独立编译一个安卓程序并且互不干扰。

4、创建后：

> （1）其中“test”解决方案名称对应上图中的“test.vsln”文件。

> （2）“模块”是当前项目自动引用的核心库模块，默认引用“Java基本类”和“安卓基本类”模块。

> > 如果需要引用更多模块，请看 模块的封装和使用方法中的“三、如何在程序中使用火山模块”。

> （3）“test”项目名称对应上图中的“test”目录。

> （4）“main.v”当前文档名称位于“test/src/”目录中，src目录为火山自动生成，知道即可无需了解其含义。

> （5）另外在“test”项目目录中，还存在一个“test.vprj”的文件，此文件为当前项目结构文件，存储了当前项目结构信息。

> 注意：如果新建了一个“test2”的项目，那么结构文件就会是“test2.vprj”。

5、一个解决方案中建立多个项目

> （1）选择“文件-新建-项目”。

> （2）选择“空窗口”后，输入“项目名称”，“所处位置”不建议修改，方便管理整体解决方案，保持原样即可。

> （3）建立完成后界面如下。

> （4）建立完成后“所处位置”处会生成一个新的文件夹“test2”，此文件夹就是项目2的文件夹。

> （5）右键项目“test”选择“设置为活动项目”，可进行项目切换。

> （6）切换项目后状态。

6、在“启动类”的代码区域右键，可以打开“启动类”的界面设计器。

7、打开后如下图所示。

> 左侧：显示了所有的窗口组件。

> 右侧：显示了窗口组件部分属性。

> 注意：“并非”所有属性都能够正常的进行设置。

> 例如：你在使用“按钮”时，无法在右侧属性栏设置“垂直滚动条滑块图”属性。

> 因为“按钮”并不具备此属性。

8、点击“按钮”可拖放到“界面设计器”内，右侧的“文本”可修改标题。

> 点击“确定”可保存布局。

9、保存后如下图所示。

10、如有“多个窗口”，想要打开指定窗口的设计器，需要在指定窗口类的代码区域右键。

10、右键“按钮”，选择“添加‘按钮1’的事件接收方法”。

11、选择“按钮_被单击”，点击“添加”。

12、添加事件后如下图所示。

13、执行单击事件需要在“返回”之前书写代码。

> 在“如果”条件命令内，指定“来源对象==按钮1”，就可以判断按钮1被单击。

> 在此行代码的下方，填写“提示信息框()”方法，就可以弹出一个信息框。

> “//”双斜线后面的文本代表注释。

> 注意：在火山中编写代码无需输入中文，只需要填写首拼即可完成代码输入。

> 例如：“如果”只需要输入“rg”。

14、最后调试程序

> 点击绿色的三角按钮可启动调试。

15、正常编译后，最终会提示“调试准备工作完成”。

> 报错“未找到任何有效安卓设备？”

16、程序打开后，点击“按钮1”就会弹出带有提示图标的“提示信息框”。

## 二、程序调试

#### ● 真机调试

> 1、进行真机调试之前首先保证手机充电口、数据线以及电脑USB接口能够正常工作且供电充足，如果电脑端使用的是拓展坞，保证拓展坞供电充足。

> 2、然后需要打开手机的“开发者选项”进入“开发者模式”，并且启用“USB调试”等设置，部分手机还存在“USB安装”选项也需要打开。

> 不同手机品牌直接打开方式基本相同，此处以小米手机为例：

> > ###### 1、打开系统设置

> > ###### 2、点击我的设备

> > ###### 3、选择全部参数与信息

> > ###### 4、连续多次点击MIUI版本即可打开开发者模式

> > ###### 5、如果已打开会提示无需此操作

> > ###### 6、回到设置界面，选择更多设置

> > ###### 7、选择开发者选项

> > ###### 8、开启开发者选项

> > ###### 9、向下滑动找到USB调试和USB安装全部打开

> 将所有设置项全部打开后，将数据线连接手机和电脑，即可点击火山工具栏中的绿色按钮进行调试。

> 需要注意的是，调试程序后可能需要在手机上点击“继续安装”才能安装软件到手机上。

> 真机调试结果：

#### ● 模拟器调试

> ##### 模拟器安装：

> > 1、首选需要下载一个安卓模拟器，这里推荐使用“雷电模拟器”。

> > 2、打开雷电官网后选择最新版点击下载。

> > 3、下载完毕后打开会看到如下界面，选择“自定义安装”。

> > 4、选择路径尽量不要选择系统盘(即C盘)，因为模拟器体积通常都很大，如果系统只有一个盘符保持默认即可，选择后点击“立即安装”。

> > 5、因雷电模拟器的安装包为在线安装包，此处耐心等待下载完毕后会自动安装。

> > 6、等待安装完毕后，点击“立即体验”即可打开模拟器。

> > 备注：如果在安装过程中遇到问题，可以咨询雷电模拟器客服，寻求解决方案。

> ##### 模拟器调试：

> > 正常情况下在雷电模拟器打开完毕后，点击火山中的绿色按钮可以直接调试成功。

> > 当遇到模拟器调试报错：未找到任何有效安卓设备？

> > 1、 打开菜单“工具-选项”。

> > 2、 找到“安卓项目管理器->全局->调试->欲连接的设备地址”，选择自己使用的模拟器，如果为雷电模拟器通常情况下无需选择。

> > 3、选择了设备依然无法调试？

> > > 假设您使用的为雷电模拟器出现无法调试的问题。

> > > 可以选择百度搜索“雷电模拟器端口号”或者咨询雷电模拟器客服人员adb端口号是多少，得到答案后在“欲连接的设备地址”中输入“IP+端口”。

> > > 如下图：雷电模拟器的端口为5554，因此提供“127.0.0.1:5554”即可。

> > 当所有工作准备完毕后，最后点击调试按钮时，会自动在模拟器中安装并打开。

## 三、编译发布版安卓程序

#### ● 填写包名

##### 1、“包名”位于所有程序代码的最上方位置。

> 通常书写格式为“公司名.程序名”，名称随意。

> 填写包名，必须保证有一个小数点，并且保证唯一性，不能与其它程序包名重复，以免造成无法安装的后果。

> 例如：腾讯QQ的包名为“com.tencent.mobileqq ”，当前程序不可填写同样的包名，会造成包名冲突，从而无法安装程序。

> 注意：确定包名后不能更改，如果程序内有多个“.v”文件，则每个文件都需要填写包名。

> 程序内多个文件的包名可重复。

#### ● 建立密钥文件

1、点击菜单“工具->安卓密钥文件建立器”。

2、填写“姓名”，名称随意，不能为中文。

> 随后点击“生成到密钥文件”后方的按钮。

3、输入“文件名”点击“保存”。

4、保存后，编辑框内就会出现保存路径。

> 最后点击“生成”。

5、点击“确定”即可完成“密钥文件建立”的所有操作。

● 设置软件信息

1、右键项目名称，选择“属性”。

2、软件必备信息设置。

> 程序标题，程序版本号，程序版本名称，程序图标以及签名用的密钥文件名。

> 依次填写完毕后，点击“确定”即可。

> 注意：软件应用市场升级软件通常以“程序版本号”为准，在升级软件时建议修改“程序版本号”。

● 编译发布版本

1、点击菜单“生成->生成活动项目”。

2、在输出栏可看到提示“编译成功”和“APK保存路径”。

3、找到输出的APK文件，安装后如下图所示。

> 可以看到“程序名称”和“图标”均被修改。

## 四、学习资源

● 图文教程

1、在线帮助文档查看：http://doc.voldp.com/

> 左侧列表中的加号可进行收缩。

2、离线帮助文档，点击菜单“帮助->帮助手册”即可打开离线帮助文档。

● 类库手册

1、点击软件左侧“类库手册”，即可查看火山类库所有类或方法。

2、首次打开“帮助页”需要双击，双击打开后即可单击切换要查看的类或方法。

3、右键想要打开帮助的方法，选择“显示‘提示信息框’的帮助内容”。

4、点击后会快速定位“提示信息框”方法。

> 点击“选择”，可以快速定位“当前方法”在“左侧列表”的位置。

5、点击“帮助页”向下拖拽，出现“小图标”后可分离“帮助页和代码框”。

6、“帮助页和代码框”分离效果图。

● 官方论坛

点击进入官方论坛：http://bbs.voldp.com/forum.php

## 五、常见问题

##### 1、没有写入权限。

> 出现这种情况的原因，通常是火山程序安装在了“系统盘”中。

> > ① 打开项目所处目录，右键空白区域，选择“属性”。

> > ② 选择“安全”在，找到当前登录用户，最后点击“编辑”。

> > ③ 找到当前系统登录用户，勾选允许。

> > ④ 会提示正在设置安全信息。

> > ⑤ 点击“确定”。

##### 2、如何新建类，常量，变量和方法？

##### 3、为什么“界面布局”菜单是灰色的？

> 第一：当前程序正在调试，停止调试即可解决。

> 第二：当前文件不位于项目中，将该文件加入到一个项目中即可解决。

> ① 右键“项目名称”选择“添加->现有文件/文档组”。

> ② 选择要添加的文件，点击“打开”。

> ③ 添加进项目后，就可以设计该程序中窗口类的布局。

##### 4、如何判断当前文件是否不位于项目中？

> 第一：如果已经打开解决方案，查看文档标题第二栏是否为"无"。 。

> 第二：如果尚未打开解决方案，则当前并无文档标题。

##### 6、火山输出提示缺少XX类？

> 确定类名没有写错，但是火山输出提示“没有找到所指定名称的类"轮播图"”。

> 此时需要添加火山模块，具体可参考“火山模块的封装和使用方法”教程中第三条：如何在程序中使用火山模块。

##### 7、调试的项目不是当前打开项目？

> 多个项目时，注意设置其调试项目为“活动项目”，右键指定项目即可设置，如下图。

##### 8、如何判断读属性？

> 判断读属性的方法很简单，在帮助页中如果遇到“属性读方法”，就证明是读属性。

> 代码编写如下图：

> 最终可以将“编辑框1”的内容读取出来显示在信息框中。

##### 9、如何判断写属性？

> 判断写属性的方法很简单，在帮助页中如果遇到“属性写方法”，就证明是写属性。

> 代码编写如下图：

> 属性写需要使用“=”连接起来，左边的为属性名右边的内容为属性值。

> 因“内容”属性值为“文本型”因此使用时需要使用引号。

> 最终单击按钮1后编辑框1会显示内容。。

##### 10、如何判断通常方法？

> 在帮助页如下位置如果看到“通常方法”四个字，代表本方法为通常方法。

> 如下图所示，通常方法需要定义变量，通过变量名称去调用。

> 运行效果如下图：

##### 11、如何判断静态方法？

> 在帮助页中看到“静态方法”四个字，就证明本方法为静态方法。

> 静态方法调用可直接通过类名访问，不需要定义变量。

> 运行结果如下图：

##### 12、如何判断全局静态方法？

> 只要类别是“全局静态方法”都可以忽略类名直接访问本方法，并且是全局性质，任何类都可以调用。

> 代码编写如下图：

> 运行结果如下图：

##### 13、未找到任何有效的安卓设备？

> 点击查看详细解决流程

##### 14、此应用专为旧版Android打造？

> 注：鸿蒙系统可能会提示“此应用专为旧版HarmonyOS打造”或“此应用的SDK版本过低”，提示信息虽然不同但设置方式是一样的。

> (1) 根据《移动应用软件高API等级预置与分发自律公约》"目标安卓平台SDK的API级别"应该设置为(26\安卓8.0) 或者更高版本。

> (2) 在火山中需要鼠标右键项目，选择“属性”。

> (3) 找到“目标安卓平台SDK的API级别”选择“26”即可解决此问题。

##### 15、软件底部出现黑色无法全屏？

> 如下所示：

> 找到“启动类”在属性名填写“@安卓.附加清单”，属性值填写“常用窗口附加清单.全面屏2”，即可解决软件底部黑色问题。

> > 注1：清单在启动类使用一次即可，如果有多个窗口其它窗口不需要填写。

> > 注2：务必使用“全面屏2”属性，此属性可以适配更长屏幕的手机。