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

作者:创世魂

 

● 教程说明

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

第一:产品安装。

第二:安卓项目建立和程序编写。

第三:调试程序

第四:编译发布版安卓程序。

第五:学习资源。

第六:常见问题。

 

一、产品安装

 

 

● 产品安装

 

1、打开下载地址:

打开“服务卡背面”的下载地址,选择合适自己的版本下载。

为保障售后服务,务必添加官方QQ群:895033329

 

2、下载后会看到如下文件。

 

 

● 安装步骤

 

1、打开安装包

打开后直接点击“下一步”

 

2、选择“我同意”,继续点击“下一步”

 

3、此处可看到“更新说明”等软件信息,继续点击“下一步”

 

4、程序默认安装路径为当前系统盘(通常为C盘),建议点击“浏览”更换安装路径。

注意:安装路径不能为中文。

 

5、根据需要勾选所需安装部分后,继续点击“下一步”

 

6、继续“下一步”

 

7、根据需求选择后,继续“下一步”

 

8、点击“安装”

 

9、安装结束后,建议勾选“VS2013运行环境”,否则火山可能无法正常运行。

 

10、“VS2013运行环境”安装。

勾选“我同意”,点击“安装”

 

11、安装完成后“关闭”即可。

 

12、安装完毕后,桌面上可以看到“火山安卓软件开发平台”

 

 

● 配置jdk/adk环境

 

1、打开火山官网:http://www.voldp.com/voldev.html,找到红色箭头所指内容,下载系统对应版本的环境包。

 

2、如果下载“64位”版本,下载完毕后,可看到此文件。

 

3、打开压缩包解压sdk.rar文件,可以将其解压到自己电脑桌面上。

 

4、打开“sdk.rar”文件,将压缩包内的“plugins”文件夹解压到火山安装路径内即可。

 

5、配置火山SDK,打开“工具->选项”。

 

6、如果使用火山提供的SDK,需保持保持sdk安装目录为空。

 

7、如果使用自己安装的sdk需要指定其根目录

 

 

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

 

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

 

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”就会弹出带有提示图标的“提示信息框”

 

三、程序调试

 

● 教程说明

 

在进行调试程序之前首先需要配置jdk/adk编译环境

配置完毕后就可以观看接下来的教程。

 

● 真机调试

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”属性,此属性可以适配更长屏幕的手机。