diff options
Diffstat (limited to 'examples/csharp/HelloworldXamarin/README.md')
| -rw-r--r-- | examples/csharp/HelloworldXamarin/README.md | 37 |
1 files changed, 37 insertions, 0 deletions
diff --git a/examples/csharp/HelloworldXamarin/README.md b/examples/csharp/HelloworldXamarin/README.md new file mode 100644 index 0000000000..e47855de5e --- /dev/null +++ b/examples/csharp/HelloworldXamarin/README.md @@ -0,0 +1,37 @@ +gRPC C# on Xamarin +======================== + +EXPERIMENTAL ONLY +------------- +Support of the Xamarin platform is currently experimental. +The example depends on experimental Grpc.Core nuget package that hasn't +been officially released and is only available via the [daily builds](https://packages.grpc.io/) +source. + +HINT: To download the package, please manually download the latest `.nupkg` packages from "Daily Builds" in [packages.grpc.io](https://packages.grpc.io/) into a local directory. Then add a nuget source that points to that directory (That can be [done in Visual Studio](https://docs.microsoft.com/en-us/nuget/tools/package-manager-ui#package-sources) or Visual Studio for Mac via "Configure nuget sources"). After that, nuget will also explore that directory when looking for packages. + +BACKGROUND +------------- +The example project supports `Xamarin.Android` and `Xamarin.iOS`. + +For this sample, we've already generated the server and client stubs from [helloworld.proto][]. + +PREREQUISITES +------------- + +- The latest version Visual Studio 2017 or Visual Studio for Mac with Xamarin support installed. + +BUILD +------- + +- Open the `HelloworldXamarin.sln` in Visual Studio (or Visual Studio for Mac) +- Build the solution (Build -> Build All) + +Try it! +------- + +You can deploy the example apps directly through Visual Studio IDE. +Deployments can target both Android and iOS (both support physical device +deployment as well as simulator). + +[helloworld.proto]:../../protos/helloworld.proto |