4.1 生日服务教程 on 编程那些事儿

4.1.1 接口

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/android/aidl/example-service/interface.html

4.1.1 接口

使用 AIDL 接口声明服务的 API：

birthday_service/aidl/com/example/birthdayservice/IBirthdayService.aidl：

1
2
3
4
5
6
7


package com.example.birthdayservice;

/** 生日服务接口。 */
interface IBirthdayService {
 /** 生成生日快乐消息。 */
 String wishHappyBirthday(String name, int years);
}

birthday_service/aidl/Android.bp：

4.1.2 服务 API

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/android/aidl/example-service/service-bindings.html

4.1.2 服务 API

Binder 会为每个接口定义生成一个 trait。

birthday_service/aidl/com/example/birthdayservice/IBirthdayService.aidl：

1
2
3
4
5


/** 生日服务接口。 */
interface IBirthdayService {
 /** 生成生日快乐消息。 */
 String wishHappyBirthday(String name, int years);
}

out/soong/.intermediates/…/com_example_birthdayservice.rs：

4.1.3 服务实现

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/android/aidl/example-service/service.html

4.1.3 服务实现

现在可以实现 AIDL 服务了：

birthday_service/src/lib.rs：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


// Copyright 2024 Google LLC
// SPDX-License-Identifier: Apache-2.0
//! `IBirthdayService` AIDL 接口的实现。
use com_example_birthdayservice::aidl::com::example::birthdayservice::IBirthdayService::IBirthdayService;
use com_example_birthdayservice::binder;

/// `IBirthdayService` 的实现。
pub struct BirthdayService;

impl binder::Interface for BirthdayService {}

impl IBirthdayService for BirthdayService {
 fn wishHappyBirthday(&self, name: &str, years: i32) -> binder::Result<String> {
 Ok(format!("Happy Birthday {name}, congratulations with the {years} years!"))
 }
}

birthday_service/Android.bp：

4.1.4 服务端

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/android/aidl/example-service/server.html

4.1.4 服务端

最后，我们可以创建一个暴露该服务的服务端：

birthday_service/src/server.rs：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


// Copyright 2024 Google LLC
// SPDX-License-Identifier: Apache-2.0
//! 生日服务。
use birthdayservice::BirthdayService;
use com_example_birthdayservice::aidl::com::example::birthdayservice::IBirthdayService::BnBirthdayService;
use com_example_birthdayservice::binder;

const SERVICE_IDENTIFIER: &str = "birthdayservice";

/// 生日服务的入口点。
fn main() {
 let birthday_service = BirthdayService;
 let birthday_service_binder = BnBirthdayService::new_binder(
 birthday_service,
 binder::BinderFeatures::default(),
 );
 binder::add_service(SERVICE_IDENTIFIER, birthday_service_binder.as_binder())
 .expect("Failed to register service");
 binder::ProcessState::join_thread_pool();
}

birthday_service/Android.bp：

4.1.5 部署

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/android/aidl/example-service/deploy.html

4.1.5 部署

现在可以构建、推送并启动服务：

1
2
3
4


m birthday_server
adb push "$ANDROID_PRODUCT_OUT/system/bin/birthday_server" /data/local/tmp
adb root
adb shell /data/local/tmp/birthday_server

在另一个终端检查服务是否在运行：

4.1.6 客户端

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/android/aidl/example-service/client.html

4.1.6 客户端

最后，可以为新服务创建一个 Rust 客户端。

birthday_service/src/client.rs：

// Copyright 2024 Google LLC
// SPDX-License-Identifier: Apache-2.0
use com_example_birthdayservice::aidl::com::example::birthdayservice::IBirthdayService::IBirthdayService;
use com_example_birthdayservice::binder;

const SERVICE_IDENTIFIER: &str = "birthdayservice";

/// Call the birthday service.
fn main() -> Result<(), Box<dyn Error>> {
 let name = std::env::args().nth(1).unwrap_or_else(|| String::from("Bob"));
 let years = std::env::args()
 .nth(2)
 .and_then(|arg| arg.parse::<i32>().ok())
 .unwrap_or(42);

 binder::ProcessState::start_thread_pool();
 let service = binder::get_interface::<dyn IBirthdayService>(SERVICE_IDENTIFIER)
 .map_err(|_| "Failed to connect to BirthdayService")?;

 // Call the service.
 let msg = service.wishHappyBirthday(&name, years)?;
 println!("{msg}");
}

birthday_service/Android.bp：

4.1.7 更改 API

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/android/aidl/example-service/changing-definition.html

4.1.7 更改 API

扩展一下 API：让客户端能为生日贺卡指定一系列行：

1
2
3
4
5
6
7


package com.example.birthdayservice;

/** 生日服务接口。 */
interface IBirthdayService {
 /** 生成生日快乐消息。 */
 String wishHappyBirthday(String name, int years, in String[] text);
}

这会得到更新后的 IBirthdayService trait 定义：

4.1.8 更新实现

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/android/aidl/example-service/changing-implementation.html

4.1.8 更新实现

更新客户端与服务端代码以适配新 API。

birthday_service/src/lib.rs：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21


// Copyright 2024 Google LLC
// SPDX-License-Identifier: Apache-2.0
impl IBirthdayService for BirthdayService {
 fn wishHappyBirthday(
 &self,
 name: &str,
 years: i32,
 text: &[String],
 ) -> binder::Result<String> {
 let mut msg = format!(
 "Happy Birthday {name}, congratulations with the {years} years!",
 );

 for line in text {
 msg.push('\n');
 msg.push_str(line);
 }

 Ok(msg)
 }
}

birthday_service/src/client.rs：