1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
|
# 安装
## 1. Linux源码安装
源码安装需要一些前置依赖：CMake（要求3.6以上）、OpenSSL(推荐1.1及以上)、Protobuf（要求3.5及以上）
默认会编译出：
1. 静态库：libsrpc.a（或者dylib）
2. 动态库：libsrpc.so（或者dll）
3. 用于生成代码的二进制工具：srpc_generator
- **cmake**
~~~sh
git clone --recursive https://github.com/sogou/srpc.git
cd srpc
make
make install
# 编译示例
cd tutorial
make
~~~
- **bazel（二选一）**
~~~sh
git clone --recursive https://github.com/sogou/srpc.git
cd srpc
bazel build ...
# 在bazel-bin/目录下，编译出lib和srpc_generator以及所有示例编译出来的可执行文件
~~~
此外，还可以借助srpc_tools安装和部署脚手架。小工具用法参考：[srpc/tools/README_cn.md](srpc/tools/README_cn.md)
Workflow、snappy和lz4也可以系统预装，如果third_party中没有通过`--recursive`参数拉取源码依赖，则会从系统默认安装路径寻找，snappy的预装要求版本是v1.1.6或以上。
如果需要源码安装`Protobuf`，参考命令：
~~~sh
git clone -b 3.20.x https://github.com/protocolbuffers/protobuf.git protobuf.3.20
cd protobuf.3.20
sh autogen.sh
./configure
make
make install
~~~
## 2. Debian Linux和Ubuntu自带安装包
SRPC已经打包到Debian，目前是Debian sid(unstable)的自带安装包，最终会进入stable的repository。
需要编辑/etc/apt/sources.list文件，才能访问unstable的repository：
sources.list文件格式: `deb <respository server/mirror> <repository name> <sub branches of the repo>`
将'unstable'字段加到我们的repo中，作为sub branch之一:
~~~~sh
deb http://deb.debian.org/ main contrib non-free
-->
deb http://deb.debian.org/ unstable main contrib non-free
~~~~
然后update我们的repo列表，就可以安装SRPC：
~~~~sh
sudo apt-get update
~~~~
安装SRPC库用于开发：
~~~~sh
sudo apt-get install libsrpc-dev
~~~~
安装SRPC库用于部署：
~~~~sh
sudo apt-get install libsrpc
~~~~
## 3. Fedora Linux自带安装包
SRPC已经是Fedora系统的自带安装包。
为了开发目的安装srpc库：
~~~sh
sudo dnf install srpc-devel
~~~
要安装srpc库以进行部署，请执行以下操作：
~~~sh
sudo dnf install srpc
~~~
## 4. Windows下安装
Windows版下srpc代码无差异，注意需要依赖Workflow的[windows分支](https://github.com/sogou/workflow/tree/windows)。
另外，srpc_tools暂时不支持Windows下使用。
## 5. MacOS源码安装
- 安装依赖 `OpenSSL`
```
brew install openssl
```
- 安装 `CMake`
```
brew install cmake
```
- 指定 `OpenSSL` 环境变量
由于MacOS下默认有LibreSSL，因此在brew安装后，并不会自动建软链，我们需要手动把执行路径、编译路径、cmake时的find_package路径都配置到bash的环境变量中。用户可以执行`brew info openssl`查看相关信息，也可以如下配置：
```
echo 'export PATH="/usr/local/opt/openssl@1.1/bin:$PATH"' >> ~/.bash_profile
echo 'export LDFLAGS="-L/usr/local/opt/openssl@1.1/lib"' >> ~/.bash_profile
echo 'export CPPFLAGS="-I/usr/local/opt/openssl@1.1/include"' >> ~/.bash_profile
echo 'export PKG_CONFIG_PATH="/usr/local/opt/openssl@1.1/lib/pkgconfig"' >> ~/.bash_profile
echo 'export OPENSSL_ROOT_DIR=/usr/local/opt/openssl' >> ~/.bash_profile
echo 'export OPENSSL_LIBRARIES=/usr/local/opt/openssl/lib' >> ~/.bash_profile
```
如果使用zsh，则还需要以下一步，把bash的配置加载一下：
```
echo 'test -f ~/.bash_profile && source ~/.bash_profile' >> ~/.zshrc
source ~/.zshrc
```
剩下的步骤和Linux下编译没有区别。
|
