# 运行示例应用程序
以下工作流程展示了如何在 Qualcomm 设备上开始使用图形应用程序。
**图：图形应用程序的工作流**
## 编译和运行基于 OpenGL ES 的应用程序
平台 eSDK 提供了一个名为 glmark2 的基于 OpenGL ES 的示例应用程序。此应用程序使用 OpenGL ES API 渲染各种场景。
要编译和运行基于 OpenGL ES 的应用程序，您必须了解 [OpenGL ES API](https://registry.khronos.org/OpenGL/specs/es/3.0/es_spec_3.0.pdf)。
**前提条件**
- 使用以下任一方法安装 Platform eSDK：
- [使用 Qualcomm 发布存档](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-51/install-sdk.html#download-qim-platform-esdk)
- [手动编译 Qualcomm Linux SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/how_to.html#generate-an-esdk)
- 从 Linux 主机到设备建立 SSH 连接。有关说明，请参阅[使用 SSH 登录](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/how_to.html#use-ssh)。
- 确保 Weston 应用程序正在运行。否则，请通过运行以下命令启动 Weston 应用程序：
>
>
> mount -o remount,rw /
> export XDG_RUNTIME_DIR=/dev/socket/weston && mkdir -p $XDG_RUNTIME_DIR
> weston --idle-time=0 --continue-without-input
> Copy to clipboard
>
>
> 关于 Weston 应用程序的更多信息，请参阅 [Qualcomm Linux 显示指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-18)。
关于 Qualcomm Linux 设备上支持的 OpenGL ES 扩展信息，请参阅 [EGL 扩展](https://docs.qualcomm.com/doc/80-70018-19SC/topic/supported_extensions.html#supported-egl-client-extensions)。
**编译并运行 glmark2 应用程序**
1. 要在 Linux 主机上设置 SDK 环境，请运行以下命令：
source environment-setup-armv8-2a-qcom-linux
Copy to clipboard
2. 要编译并生成二进制文件，请运行以下命令：
devtool modify glmark2
devtool build glmark2
Copy to clipboard
如果遇到任何 umask 错误，请将 umask 设置为 022。
编译成功后，您可以在 `/workspace/sources/glmark2/oe-workdir/image/usr/bin` 目录中找到输出文件。
3. 要将二进制文件推送到设备，请运行以下命令：
scp -r /workspace/sources/glmark2/oe-workdir/image/usr/bin/glmark2-es2-wayland root@[IP-address-of-device]:/tmp
Copy to clipboard
scp -r /workspace/sources/glmark2/oe-workdir/image/usr/share/glmark2 root@[IP-address-of-device]:/tmp
Copy to clipboard
4. 要在设备上运行应用程序，请使用设备的 IP 地址打开 SSH 终端并运行以下命令：
export XDG_RUNTIME_DIR=/dev/socket/weston && export WAYLAND_DISPLAY=wayland-1
chmod 777 /tmp/glmark2-es2-wayland
chmod -R 777 /tmp/glmark2
cd /tmp
./glmark2-es2-wayland --data-path /tmp/glmark2 -b jellyfish
Copy to clipboard
Note
请使用以下命令重新挂载文件系统，以便从 UART shell 运行示例应用程序：
mount -o remount,rw /
Copy to clipboard
## 编译并运行基于 OpenCL 的应用程序
[Adreno OpenCL SDK](https://softwarecenter.qualcomm.com/#/catalog/item/Adreno_OpenCL_SDK) 有许多示例应用程序。编译和运行它们的步骤相同。您可以使用 Adreno OpenCL SDK 开发多个应用程序。但是，在编译和运行应用程序之前，请考虑 GPU 功能。
Note
目前，Qualcomm Linux 支持 OpenCL v2.1。
运行 hello world 应用程序的步骤如下：
**前提条件**
- 使用以下任一方法安装 Platform eSDK：
- [使用 Qualcomm 发布存档](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-51/install-sdk.html#download-qim-platform-esdk)
- [手动编译 Qualcomm Linux SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/how_to.html#generate-an-esdk)
- 从 Linux 主机到设备建立 SSH 连接。有关说明，请参阅[使用 SSH 登录](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/how_to.html#use-ssh)。
- 下载 [Adreno OpenCL SDK](https://softwarecenter.qualcomm.com/#/catalog/item/Adreno_OpenCL_SDK)。
Note
只允许注册用户下载 Adreno OpenCL SDK。
关于 Qualcomm Linux 设备上支持的 OpenCL 扩展信息，请参阅 [OpenCL 扩展](https://docs.qualcomm.com/doc/80-70018-19SC/topic/supported_extensions.html#supported-opencl-extensions)。
**编译并运行 hello world 示例应用程序**
1. 要编译应用程序，请在 Linux 主机上运行以下命令：
cd opencl-sdk
Copy to clipboard
source /environment-setup-armv8-2a-qcom-linux
Copy to clipboard
cmake -B build -DCLSDK_OPENCL_LIBRARY=$OECORE_TARGET_SYSROOT/usr/lib/libOpenCL.so -DCLSDK_DMABUFHEAP_LIBRARY=$OECORE_TARGET_SYSROOT/usr/lib/libdmabufheap.so -DOPEN_EMBEDDED=1
cmake --build build
Copy to clipboard
成功编译代码后，系统会在 `/build` 目录中生成二进制文件。
2. 要运行应用程序，请使用设备的 IP 地址打开 SSH 终端并运行以下命令：
mkdir -p /opt/data
mkdir -p /opt/data/opencl
Copy to clipboard
Note
请使用以下命令重新挂载文件系统，以便从 UART shell 运行示例应用程序：
mount -o remount,rw /
Copy to clipboard
3. 要将二进制文件推送到设备，请运行以下命令：
scp -r /build/* root@[IP-address-of-the device]:/opt/data/opencl/
Copy to clipboard
scp -r /example_images/* root@[IP-address-of-the device]:/opt/data/opencl/
Copy to clipboard
4. 请使用 SSH 终端在设备上运行以下命令，以便启动应用程序：
cd /opt/data/opencl/
mkdir out
chmod 777 ./*
echo "run hello world 2.0 opencl sdk" > hello_world_input.txt
touch out/hello_world_output.txt
cat out/hello_world_output.txt
./cl_sdk_hello_world hello_world_input.txt out/hello_world_output.txt
cat out/hello_world_output.txt
Copy to clipboard
## 编译和运行基于 Vulkan 的应用程序
Adreno SDK 有许多基于 Vulkan 的示例应用程序。编译和运行任何基于 Vulkan 的应用程序的步骤相同。您可以使用 Adreno SDK 开发基于 Vulkan 的应用程序。要编译和运行这些应用程序，请参阅以下步骤。作为示例，本节介绍了运行 Sascha Willems 和 Khronos 基于 Vulkan 的应用程序的步骤。
### 编译和运行 Sascha Willems 基于 Vulkan 的应用程序
您可以在 [https://github.com/SaschaWillems/Vulkan.git](https://github.com/SaschaWillems/Vulkan.git) 找到 Sascha Willems Vulkan 示例应用程序。编译和运行任何 Sascha Willems Vulkan 应用程序的步骤均相同。
关于 Qualcomm Linux 设备上支持的 Vulkan 扩展的信息，请参阅 [Vulkan 扩展](https://docs.qualcomm.com/doc/80-70018-19SC/topic/supported_extensions.html#supported-vulkan-extensions)。
**前提条件**
- 使用以下任一方法安装 Platform eSDK：
- [使用 Qualcomm 发布存档](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-51/install-sdk.html#download-qim-platform-esdk)
- [手动编译 Qualcomm Linux SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/how_to.html#generate-an-esdk)
- 从 Linux 主机到设备建立 SSH 连接。有关说明，请参阅[使用 SSH 登录](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/how_to.html#use-ssh)。
**编译和运行三角形 bin 示例应用程序的步骤**
1. 要编译应用程序，请在 Linux 主机上运行以下命令：
git clone --recurse-submodules https://github.com/SaschaWillems/Vulkan.git
cd Vulkan
Copy to clipboard
source /environment-setup-armv8-2a-qcom-linux
Copy to clipboard
cmake -G "Unix Makefiles" -Bbuild/linux -DUSE_WAYLAND_WSI=ON -DRESOURCE_INSTALL_DIR="/tmp/"
cmake --build build/linux --config Release -j$(nproc)
Copy to clipboard
成功编译后，您可以在 `build/linux/bin` 目录中找到二进制文件。
2. 要将二进制文件推送到设备，请运行以下命令：
cd Vulkan
Copy to clipboard
scp -r assets root@[IP-address-of-device]:/tmp/
Copy to clipboard
scp -r shaders root@[IP-address-of-device]:/tmp/
Copy to clipboard
scp -r build/linux/bin/triangle root@[IP-address-of-device]:/tmp/
Copy to clipboard
3. 要运行应用程序，请使用设备的 IP 地址打开 SSH 终端并运行以下命令：
cd /tmp
chmod -R 777 assets/
chmod -R 777 shaders/
chmod 777 triangle
export XDG_RUNTIME_DIR=/dev/socket/weston && export WAYLAND_DISPLAY=wayland-1
./triangle
Copy to clipboard
### 编译和运行 Khronos 基于 Vulkan 的应用程序
您可以在 [https://github.com/KhronosGroup/Vulkan-Samples.git](https://github.com/KhronosGroup/Vulkan-Samples.git) 找到 Khronos 基于 Vulkan 的应用程序。编译和运行任何 Khronos 基于 Vulkan 的应用程序的步骤都是相同的。
关于 Qualcomm Linux 设备上支持的 Vulkan 扩展的信息，请参阅 [Vulkan 扩展](https://docs.qualcomm.com/doc/80-70018-19SC/topic/supported_extensions.html#supported-vulkan-extensions)。
**前提条件**
- 使用以下任一方法安装 Platform eSDK：
- [使用 Qualcomm 发布存档](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-51/install-sdk.html#download-qim-platform-esdk)
- [手动编译 Qualcomm Linux SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/how_to.html#generate-an-esdk)
- 从 Linux 主机到设备建立 SSH 连接。有关说明，请参阅[使用 SSH 登录](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/how_to.html#use-ssh)。
**编译和运行 vulkan\_samples 应用程序的步骤**
1. 要编译应用程序，请在 Linux 主机上运行以下命令：
sudo apt-get install -y libwayland-dev
git clone --recurse-submodules https://github.com/KhronosGroup/Vulkan-Samples.git
cd Vulkan-Samples/
Copy to clipboard
source /environment-setup-armv8-2a-qcom-linux
Copy to clipboard
cmake -G "Unix Makefiles" -Bbuild/linux -DCMAKE_BUILD_TYPE=Release -DVKB_WSI_SELECTION=WAYLAND -DGLFW_BUILD_X11=OFF
Copy to clipboard
如果编译失败，则执行以下操作：
1. 打开 `Vulkan-Samples/build/linux/CmakeCache.txt` 文件。
2. 将 `GLFW_BUILD_X11` 更改为 `OFF`。
2. 要生成二进制文件，请运行以下命令：
cmake --build build/linux --config Release --target vulkan_samples -j$(nproc)
Copy to clipboard
成功编译后，您可以在 `Vulkan-Samples/build/linux/app/bin/Release/aarch64` 目录中找到二进制文件。
3. 要将二进制文件推送到设备，请运行以下命令：
cd Vulkan-Samples
Copy to clipboard
scp -r assets root@[IP-address-of-device]:/tmp/
Copy to clipboard
scp -r shaders root@[IP-address-of-device]:/tmp/
Copy to clipboard
scp -r build/linux/app/bin/Release/aarch64/vulkan_samples root@[IP-address-of-device]:/tmp/
Copy to clipboard
4. 要运行应用程序，请使用设备的 IP 地址打开 SSH 终端并运行以下命令：
cd /tmp
chmod -R 777 assets/
chmod -R 777 shaders/
chmod 777 vulkan_samples
export XDG_RUNTIME_DIR=/dev/socket/weston && export WAYLAND_DISPLAY=wayland-1
./vulkan_samples sample swapchain_images
Copy to clipboard
Note
如果在编译或运行应用程序时遇到问题，请使用以下命令检出特定版本。之后，重复步骤 2 到 4，重新编译并运行应用程序。
git checkout b3cb3822e8896ab650c4310f2c5f66a101469e9e
git submodule sync
git submodule update
Copy to clipboard
如果由于存储问题而无法从 `/tmp` 目录运行这些示例应用程序，请尝试其他目录，例如 `/etc`。
Last Published: May 06, 2025
[Previous Topic
图形概述](https://docs.qualcomm.com/bundle/publicresource/80-70018-19SC/topics/graphics-overview.md) [Next Topic
Snapdragon Profiler 工具](https://docs.qualcomm.com/bundle/publicresource/80-70018-19SC/topics/graphics_developer_tools.md)