第15章 SDL开发环境搭建

课程目录第15章 SDL开发环境搭建

SDL开发环境搭建：从零开始跑通你的第一个车载应用

说实话，SDL开发环境搭建这件事，我当年第一次搞的时候也踩了不少坑。那时候文档还不像现在这么全，光是把SDL Core编译通过就折腾了两天。今天我把这些经验整理出来，希望能帮你少走弯路。

SDL的整个开发环境，说白了就是四件套：Core、Android Proxy、Policy Server、模拟器。咱们一个一个来搞定。

1. SDL Core 编译与部署

SDL Core 是车载端的核心服务，它负责跟手机上的 App 通信，然后把界面渲染到车机屏幕上。我个人习惯在 Ubuntu 20.04 上编译，因为依赖库最全，踩坑最少。

核心依赖：

CMake >= 3.10
g++ 支持 C++14
libssl-dev、libboost-all-dev
libsqlite3-dev、libudev-dev

编译步骤其实不复杂，但有几个细节要注意。先克隆代码，然后切到稳定分支——我记得有一次直接用了 master 分支，结果编译出来跑不起来，后来发现是开发中的代码，API 还没稳定。

# 克隆 SDL Core 源码
git clone https://github.com/smartdevicelink/sdl_core.git
cd sdl_core

# 切到稳定版本（我建议用 7.1.0 或更新）
git checkout release/7.1.0

# 创建构建目录
mkdir build && cd build

# CMake 配置
cmake .. -DCMAKE_BUILD_TYPE=Release \
         -DBUILD_TESTS=OFF \
         -DEXTENDED_POLICY=ON

# 编译（-j 后面的数字根据你的 CPU 核心数调整）
make -j4

我的小技巧： 编译时加上 -DCMAKE_INSTALL_PREFIX=/opt/sdl_core，这样编译完直接 make install 就能装到指定目录，方便管理多个版本。

编译完成后，你会得到几个关键的可执行文件：SDLCore、PolicyManager、AppManifestValidator。部署的时候，我一般把整个 build/bin 目录拷贝到车机上，然后写个 systemd 服务让它开机自启。

2. Android Proxy 集成

Android Proxy 是手机端 App 用来跟 SDL Core 通信的 SDK。说白了，它就是帮你封装了所有 SDL 协议细节，你只需要调几个接口就行。

集成方式很简单，在 build.gradle 里加一行依赖：

dependencies {
    implementation 'com.smartdevicelink:sdl_android:7.1.0'
}

嗯，这里要注意版本号一定要跟 SDL Core 匹配。我曾经遇到过 Core 是 7.0 但 Proxy 用了 7.1，结果某些 RPC 消息解析失败，查了半天才发现是版本不兼容。

初始化 Proxy 的代码大概长这样：

// 在 Application 或 MainActivity 中初始化
SdlManager.Builder builder = new SdlManager.Builder(this, APP_ID, 
    new SdlManagerCallback() {
        @Override
        public void onProxyConnected() {
            // 连接成功，可以开始注册应用了
            Log.d("SDL", "Proxy connected!");
        }

        @Override
        public void onProxyDisconnected() {
            // 断开连接，做清理工作
            Log.d("SDL", "Proxy disconnected");
        }
    });

// 设置传输方式（WiFi 或 USB）
builder.setTransportType(TransportType.WIFI);

SdlManager sdlManager = builder.build();
sdlManager.start();

避坑指南： 我曾经在 Android 11 上遇到 TransportType.USB 连不上车机的问题，后来发现是 USB 权限没配置。记得在 AndroidManifest.xml 里加上 <uses-permission android:name="android.permission.USB_PERMISSION" />。

3. Policy Server 配置

Policy Server 是 SDL 生态里容易被忽略但极其重要的一环。它决定了你的 App 能调用哪些 RPC、能访问哪些功能。说白了，车厂通过 Policy Server 来控制第三方 App 的权限。

SDL 官方提供了一个基于 Node.js 的 Policy Server 实现。配置起来也不复杂：

# 克隆 Policy Server
git clone https://github.com/smartdevicelink/sdl_policy_server.git
cd sdl_policy_server

# 安装依赖
npm install

# 复制配置文件
cp config/default.js config/local.js

然后编辑 config/local.js，主要配置数据库连接和监听端口：

module.exports = {
  server: {
    port: 3001,
    host: '0.0.0.0'
  },
  database: {
    // 我建议用 SQLite 做本地测试，生产环境再用 PostgreSQL
    dialect: 'sqlite',
    storage: './data/policy.db'
  },
  sdl: {
    // 允许的应用列表
    allowedApps: ['YOUR_APP_ID']
  }
};

我的经验： 开发阶段可以把 allowedApps 设为 ['*']，这样所有 App 都能连上来调试。但上线前一定要改成白名单模式，不然安全审计过不了。

启动 Policy Server：

npm start

启动后，SDL Core 会定期向 Policy Server 请求策略更新。你可以在 Policy Server 的管理界面里查看已连接的设备、App 列表，还能动态调整权限。

4. SDL 模拟器测试

没有真车机的时候怎么办？SDL 官方提供了一个基于 Web 的模拟器，叫 SDL HMI（Human Machine Interface）。它模拟了车机屏幕，你可以在浏览器里看到 App 的界面渲染效果。

模拟器的启动顺序有讲究，我刚开始搞的时候顺序搞反了，结果怎么都连不上。正确的顺序是：

先启动 Policy Server（确保策略服务可用）
再启动 SDL Core（Core 启动时会连接 Policy Server）
最后启动 HMI 模拟器（模拟器连接 Core）

启动 HMI 模拟器：

# 克隆 HMI 项目
git clone https://github.com/smartdevicelink/sdl_hmi.git
cd sdl_hmi

# 安装依赖
npm install

# 启动（默认端口 8080）
npm start

打开浏览器访问 http://localhost:8080，你会看到一个模拟的车机屏幕。这时候在手机上运行你的 App，它就会自动发现 SDL Core 并建立连接。

验证全链路是否打通：

手机 App 显示 "Connected to SDL Core"
HMI 模拟器上出现 App 图标
点击图标，App 的界面渲染到模拟器屏幕上
Policy Server 后台显示设备在线

我曾经踩过的坑： 模拟器连不上 Core 的时候，先检查防火墙。SDL Core 默认监听 12345 端口，HMI 监听 8080 端口。还有一次是因为 WiFi 网络隔离，手机和电脑不在同一个网段，折腾了半天才发现是网络问题。

整个环境搭建好之后，你就可以开始愉快的 SDL 应用开发了。记住，开发阶段多用模拟器调试，等逻辑都跑通了再上真车机测试，这样效率最高。

公众号:蓝海资料掘金营，微信deep3321

📚 课程目录

SDL开发环境搭建：从零开始跑通你的第一个车载应用

1. SDL Core 编译与部署

2. Android Proxy 集成

3. Policy Server 配置

4. SDL 模拟器测试