grpc-java examples运行及遇到的问题

前言

调试运行grpc-java官方demo，examples。
默认你已经下载了androidstudio，并配置好了android开发环境。
这是本人在运行demo过程中的总结，如需查看官方文档，请参阅grpc-java-android-quickstart

1.调试运行

首先，我们需要将grpc-java从github仓库clone到我们的本地。

git clone -b v1.51.1 https://github.com/grpc/grpc-java

然后进入到examples目录

cd grpc-java/examples

生成server端代码

./gradlew installDist

运行服务

 ./build/install/examples/bin/hello-world-server
INFO: Server started, listening on 50051

然后进入android/helloworld目录

cd android/helloworld

安装apk

../../gradlew installDebug

修改端口映射

adb reverse tcp:8080 tcp:50051

此时，我们在app中host输入localhost，port输入8080，message中输入hello，就可以看到response了。

可能遇到的问题

A problem occurred configuring project ':app'.
> Could not create task ':app:minifyReleaseWithR8'.
   > SDK location not found. Define location with an ANDROID_SDK_ROOT environment variable or by setting the sdk.dir path in your project's local
 properties file at 'D:\AndroidOpenSourceProject\grpc-java\examples\android\helloworld\local.properties'.

这是因为我们没有在环境变量中设置ANDROID_SDK_ROOT，因为我们设置的环境变量名称一般取名为ANDROID_SDK_HOME。
解决方法是，不需要修改环境变量中的命名，我们可以在项目的根目录，找到loca.properties文件，将其复制到android/helloword目录下，然后再执行

../../gradlew installDebug

命令即可。

2.修改代码后调试运行

1.修改grpc service声明

找到src/main/proto/helloworld.proto目录下面的helloworld.proto，
注意，是在examples/src目录下，不是examples/android目录下。
打开文件会发现定义的service文件如下：

// The greeting service definition.
service Greeter {
  // Sends a greeting
  rpc SayHello (HelloRequest) returns (HelloReply) {}
}

// The request message containing the user's name.
message HelloRequest {
  string name = 1;
}

// The response message containing the greetings
message HelloReply {
  string message = 1;
}

然后我们新增sayHelloAgain方法，如下：

// The greeting service definition.
service Greeter {
  // Sends a greeting
  rpc SayHello (HelloRequest) returns (HelloReply) {}
  // Sends another greeting
  rpc SayHelloAgain (HelloRequest) returns (HelloReply) {}
}

// The request message containing the user's name.
message HelloRequest {
  string name = 1;
}

// The response message containing the greetings
message HelloReply {
  string message = 1;
}

2.修改server文件

打开src/main/java/io/grpc/examples/helloworld/HelloWorldServer.java目录下该文件

private class GreeterImpl extends GreeterGrpc.GreeterImplBase {

  @Override
  public void sayHello(HelloRequest req, StreamObserver<HelloReply> responseObserver) {
    HelloReply reply = HelloReply.newBuilder().setMessage("Hello " + req.getName()).build();
    responseObserver.onNext(reply);
    responseObserver.onCompleted();
  }
	//这是新增的方法
  @Override
  public void sayHelloAgain(HelloRequest req, StreamObserver<HelloReply> responseObserver) {
    HelloReply reply = HelloReply.newBuilder().setMessage("Hello again " + req.getName()).build();
    responseObserver.onNext(reply);
    responseObserver.onCompleted();
  }
}

3.修改client文件

打开src/main/java/io/grpc/examples/helloworld/HelloWorldClient.java

public void greet(String name) {
  logger.info("Will try to greet " + name + " ...");
  HelloRequest request = HelloRequest.newBuilder().setName(name).build();
  HelloReply response;
  try {
    response = blockingStub.sayHello(request);
  } catch (StatusRuntimeException e) {
    logger.log(Level.WARNING, "RPC failed: {0}", e.getStatus());
    return;
  }
  logger.info("Greeting: " + response.getMessage());
  // 以下是新增的方法
  try {
    response = blockingStub.sayHelloAgain(request);
  } catch (StatusRuntimeException e) {
    logger.log(Level.WARNING, "RPC failed: {0}", e.getStatus());
    return;
  }
  logger.info("Greeting: " + response.getMessage());
}

最后，再次按照开始的步骤调试运行，就可以发现调用了新增的方法。