grpc-swift/Samples

Swift gRPC Packages

This directory contains the Swift gRPC API and related components in the form of buildable Swift packages.

Follow these steps to build and run them 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.1-release/ubuntu1604/swift-3.0.1-RELEASE/swift-3.0.1-RELEASE-ubuntu16.04.tar.gz
tar xzf swift-3.0.1-RELEASE-ubuntu16.04.tar.gz
ln -s swift-3.0.1-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
git submodule update --init
cd third_party/grpc
git submodule update --init
make
make install

Build the samples

cd
cd grpc-swift/Samples
cd SimpleServer; make; cd ..
cd SimpleClient; make; cd ..
cd EchoServer; make; cd ..
cd EchoClient; make; cd ..

Run the test client and server from the grpc/src/swift/Packages directory:

SimpleServer/.build/debug/SimpleServer &
SimpleClient/.build/debug/SimpleClient  

or

EchoServer/.build/debug/EchoServer &
EchoClient/.build/debug/EchoClient