# 开发示例

本节主要介绍 VSOA 开发示例及其使用方法。

# 开发示例介绍

VSOA 开发示例是 RealEvo-CloudNative 提供的一系列示例程序，在 安装 RealEvo-CloudNative 后即可使用，可用来验证云原生运行环境是否正常。熟练掌握 VSOA 开发示例的使用，可以帮助用户加深对 VSOA 微服务架构的理解，提高开发效率。

• VSOA 开发示例的程序

  程序名	程序介绍
  client	客户端示例
  position	位置服务示例
  server	服务端示例
  timer	定时器示例

• VSOA 开发示例的位置

  • 创建云原生 SDK 后，可以在工程路径“src/vsoa/$(arch)/vsoa/vsoa/example”下找到 VSOA 的开发示例代码，其中“$(arch)”为当前工程对应的架构。
  • 编译云原生 SDK 后，会在工程路径“src/vsoa/$(arch)/vsoa/Release”下生成开发示例程序，其中“$(arch)”为当前工程对应的架构。
  • 部署云原生 SDK 后，开发示例将会被部署到对应的板卡上，部署路径为“/apps/vsoa/example/c”。

# 开发示例使用

本节将对 VSOA 功能示例进行使用说明。其中 RPC 功能示例包括 server（服务端）、position（位置服务） 和 client（客户端） 三个程序，详细的架构说明见 VSOA 架构。

1. 配置位置服务的地址与端口号。通过配置环境变量的方式进行配置，并执行 varsave 命令保存配置。

   [root@sylixos:/root]# VSOA_POS_SERVER=127.0.0.1:3000
   [root@sylixos:/root]# varsave
   
2. 进入示例程序的部署路径。

   [root@sylixos:/root]# cd /apps/vsoa/example/c
   
3. 启动位置服务。

   说明：
   建议后台运行，否则执行其它程序时，需要额外开启另一终端。

   [root@sylixos:/apps/vsoa/example/c]# ./position &
   
4. 启动服务端程序。

   [root@sylixos:/apps/vsoa/example/c]# ./server &
   
5. 启动客户端示例程序。

   [root@sylixos:/apps/vsoa/example/c]# ./client
   
   运行结果如下：

由运行结果可知，微服务运行环境正常。其它验证程序的使用，请参考上述步骤。

说明：

• 使用 VSOA 开发的微服务应用程序支持在宿主机环境中运行。
• 在生产环境中，微服务需要运行在容器环境中，打包和部署方法详见 打包 C/C++ 微服务 和 部署容器镜像。