Skip to content

Latest commit

 

History

History
86 lines (66 loc) · 2.14 KB

LINUX.md

File metadata and controls

86 lines (66 loc) · 2.14 KB
Raw

Swift gRPC Samples

Follow these steps to build and run Swift gRPC on Linux.

Prerequisites

These instructions are for running in the Docker container manager, but can be directly used on any Ubuntu 16.04 image.

Start Docker

Start a docker instance with the following command:

docker run -i -t --privileged=true ubuntu:16.04 /bin/bash

Install Dependencies

# update package list
apt-get update
# install download tools
apt-get install -y git wget
# install a few useful utilities
apt-get install -y vim sudo
# install grpc build dependencies
apt-get install -y build-essential autoconf libtool
# install swift dependencies
apt-get install -y clang libicu-dev libedit-dev python-dev libxml2-dev
# install networking dependencies
apt-get install -y libcurl4-openssl-dev

Install Swift

# go to /root
cd
# download and unpack swift
wget https://swift.org/builds/swift-3.0.2-release/ubuntu1604/swift-3.0.2-RELEASE/swift-3.0.2-RELEASE-ubuntu16.04.tar.gz
tar xzf swift-3.0.2-RELEASE-ubuntu16.04.tar.gz
ln -s swift-3.0.2-RELEASE-ubuntu16.04 swift

Add Swift to your path

# add swift to your path by adding this to your .bashrc
export PATH=/root/swift/usr/bin:$PATH

# Then run this to update your path
source ~/.bashrc

Configure git

git config --global user.email <your email address>
git config --global user.name "<your name>"

Fetch and build grpc

git clone https://github.com/grpc/grpc-swift
cd grpc-swift
cd third_party
sh RUNME.sh
cd grpc
git submodule update --init
make
make install

Build the Echo sample

cd
cd grpc-swift/Examples/Echo/PackageManager
make

Run the test client and server

# start the server
.build/debug/Echo serve &
# run the client to test each Echo API
.build/debug/Echo get
.build/debug/Echo expand
.build/debug/Echo collect
.build/debug/Echo update

To test the plugin

# build and install protoc
cd
cd grpc-swift/third_party/grpc/third_party/protobuf 
make install
# build and test the plugin
cd
cd grpc-swift/Plugin
make test