记一次技术调研(一): iOS 应用实现 gRPC 调用

时间 2019-11-30

标签一次技术调研 ios 应用实现 grpc 调用栏目 iOS 繁體版

原文原文链接

问题java

在手机应用的开发中，一般会将复杂的业务逻辑层实现放在服务端，客户端仅负责表现层。可是对于某些手机应用而言，业务逻辑的实现位于服务端反而是不安全的或是不合理的，而是须要将其逻辑直接在手机端实现。ios

目的git

面对不一样系统的手机客户端，单独重复实现相同的业务逻辑，并不是最佳实践。如何经过第三方语言 Go 语言将业务逻辑封装成库的形式，并以静态打包的方式提供给不一样系统的手机客户端使用，是本次调研的目的。程序员

理想目标图：github

具体调研内容包括:golang

其中关于 gRPC 在 iOS 与 Android 的实现，自己官方就已经提供了样例。本次调研会用到相关内容，因此将其做为调研的一部分记录下来，方便后来者阅读。调研中全部涉及的项目代码均存放于: liujianping/grpc-apps 仓库中，须要的朋友能够直接下载测试。swift

更多最新文章请关注我的站点：GitDiG.com, 原文地址：iOS 应用实现 gRPC 调用 .vim

1. 环境安装

做为一名非专职 iOS 的程序员，常常须要调研陌生的技术或者语言。首先是要克服对于未知的畏惧心理。其实不少东西没那么难，只是须要开始而已。为了完成目标调研，开始第一部分的调研工做。以文字形式记录下来，方便后来者。后端

1.1 XCode 安装

没什么好说的，直接 AppStore 下载安装。有点慢，一边下载一边准备其它环境。xcode

1.2 Cocoapod 安装

相似与其它语言的第三方库管理工具。也没什么好说的，登陆官网，按说明安装。

$: sudo gem install cocoapods
复制代码

1.3 protoc 命令安装

由于 gRPC 的普遍使用， ProtoBuf 协议被普遍用于字节编码与解码的协议，其具体指南参考官网。话很少说，安装：

$: curl -LOk https://github.com/protocolbuffers/protobuf/releases/download/v3.5.1/protoc-3.9.0-rc-1-osx-x86_64.zip
$: unzip protoc-3.9.0-rc-1-osx-x86_64.zip -d proto_buffer && cd proto_buffer
$: sudo cp bin/protoc /usr/local/bin
$: sudo cp -R include/google/protobuf/ /usr/local/include/google/protobuf
$: protoc --version
复制代码

1.4 protoc 插件安装

protoc 主要是经过解析 .proto 格式的文件, 再根据具体插件生成相应语言代码。考虑到须要同时实现客户端与服务端的代码，因此必须安装如下三个插件：

swift
swiftgrpc
go 主要生成 go 代码，用于服务端实现

swift 插件安装：

$: git clone https://github.com/grpc/grpc-swift.git
$: cd grpc-swift
$: git checkout tags/0.5.1
$: make
$: sudo cp protoc-gen-swift protoc-gen-swiftgrpc /usr/local/bin
复制代码

go 插件安装：

前提是须要安装 Go 语言的开发环境，可参考官网。protoc-gen-go安装详细指南.

$: go get -u github.com/golang/protobuf/protoc-gen-go
复制代码

2 定义 proto 接口

既然是最简单的调研，就用最简单的 Hello 服务。建立项目路径并定义：

$: mkdir grpc-apps
$: cd grpc-apps
$: mkdir proto
$: cat <<EOF > proto/hello.proto
syntax = "proto3";

option java_multiple_files = true;
option java_package = "com.gitdig.helloworld";
option java_outer_classname = "HelloWorldProto";

package helloworld;

service Greeter {
  rpc SayHello (HelloRequest) returns (HelloReply) {}
}

message HelloRequest {
  string name = 1;
}

message HelloReply {
  string message = 1;
}
EOF
复制代码

3. 服务端实现

在项目目录中建立服务端目录与proto生成目录，同时编写一个简单的服务端：

$: cd grpc-apps
$: mkdir go go/client go/server go/hello
# 生成 Go 代码到 go/hello 文件夹
$: protoc -I proto proto/hello.proto --go_out=plugins=grpc:./go/hello/
复制代码

分别编辑 Go 版本 client 与 server 实现。确认服务正常运行。

3.1 Go 服务端

编辑 server/server.go 文件：

package main

import (
	pb "github.com/liujianping/grpc-apps/go/helloworld"
)

import (
	"context"
	"fmt"
	"log"
	"net"

	"google.golang.org/grpc"
)

type HelloServer struct{}

// SayHello says 'hi' to the user.
func (hs *HelloServer) SayHello(ctx context.Context, req *pb.HelloRequest) (*pb.HelloReply, error) {
	// create response
	res := &pb.HelloReply{
		Message: fmt.Sprintf("hello %s from go", req.Name),
	}

	return res, nil
}

func main() {
	var err error

	// create socket listener
	l, err := net.Listen("tcp", ":50051")
	if err != nil {
		log.Fatalf("error: %v\n", err)
	}

	// create server
	helloServer := &HelloServer{}

	// register server with grpc
	s := grpc.NewServer()
	pb.RegisterGreeterServer(s, helloServer)

	log.Println("server serving at: :50051")
	// run
	s.Serve(l)
}

复制代码

运行服务端程序:

$: cd grpc-apps/go
$: go run server/server.go
2019/07/03 20:31:06 server serving at: :50051
复制代码

3.2 Go 客户端

编辑 client/client.go 文件：

package main

import (
	pb "github.com/liujianping/grpc-apps/go/helloworld"
)

import (
	"context"
	"fmt"
	"log"

	"google.golang.org/grpc"
)

func main() {
	var err error

	// connect to server
	conn, err := grpc.Dial("localhost:50051", grpc.WithInsecure())
	if err != nil {
		log.Fatalf("error: %v\n", err)
	}
	defer conn.Close()

	// create client
	client := pb.NewGreeterClient(conn)

	// create request
	req := &pb.HelloRequest{Name: "JayL"}

	// call method
	res, err := client.SayHello(context.Background(), req)
	if err != nil {
		log.Fatalf("error: %v\n", err)
	}

	// handle response
	fmt.Printf("Received: \"%s\"\n", res.Message)
}

复制代码

执行客户端程序：

$: cd grpc-apps/go
$: go run client/client.go
Received: "hello JayL from go"
复制代码

Go 客户端/服务端通讯成功。

4. iOS 项目

4.1 建立一个最简单的单视图项目

建立一个名为 iosDemo 的单视图项目，选择 swift 语言，存储路径放在 grpc-apps 下。完成建立后，正常运行，退出程序。

4.2 初始化项目 Pod

在命令行执行初始化:

$: cd grpc-apps/iosDemo
# 初始化
$: pod init
$: vim Podfile
复制代码

编辑 Podfile 以下:

# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'

target 'iosDemo' do
  # Comment the next line if you don't want to use dynamic frameworks
  use_frameworks!

  # Pods for iosDemo
  pod 'SwiftGRPC'
end
复制代码

完成编辑后保存，执行安装命令:

$: pod install
复制代码

安装完成后，项目目录发生如下变动：

$: git status
On branch master
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)

	modified:   iosDemo.xcodeproj/project.pbxproj

Untracked files:
  (use "git add <file>..." to include in what will be committed)

	Podfile
	Podfile.lock
	Pods/
	iosDemo.xcworkspace/

no changes added to commit (use "git add" and/or "git commit -a")
复制代码

经过命令行 open iosDemo.xcworkspace 打开项目，对项目中的info.list的如下设置进行修改：

经过设置，开启非安全的HTTP访问方式。

4.3 生成 gRPC swift 代码

相似 Go 代码生成，如今生成 swift 代码：

$: cd grpc-apps
# 建立生成文件存放目录
$: mkdir swift
# 生成 swift 文件
$: protoc -I proto proto/hello.proto \
    --swift_out=./swift/ \
    --swiftgrpc_out=Client=true,Server=false:./swift/
# 生成文件查看
$: tree swift
swift
├── hello.grpc.swift
└── hello.pb.swift
复制代码

4.4 将生成代码集成到 iOS 项目

XCode中添加生成代码须要经过拖拽的方式，对于后端开发而言，确实有点不可理喻。不过既然必须这样就按照规则：

如今在 iOS 的视图加载函数增长 gRPC 调用过程:

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        let client = Helloworld_GreeterServiceClient(address: ":50051", secure: false)
        var req = Helloworld_HelloRequest()
        req.name = "JayL"
        do {
            let resp = try client.sayHello(req)
            print("resp: \(resp.message)")
        } catch {
            print("error: \(error.localizedDescription)")
        }
    }
}
复制代码

查看日志输出resp: hello iOS from go, iOS 应用调用 gRPC 服务成功。