From 1b36ca622c536057a555aea41e81e614a271c8db Mon Sep 17 00:00:00 2001 From: jzeferino Date: Thu, 2 Aug 2018 14:48:35 +0100 Subject: [PATCH 1/3] Improved Xamarin example doc. Xamarin Studio is no longer preferred for Xamarin development, we should use Visual Studio for Mac. Also added more info on how to use the nuget package source. --- examples/csharp/HelloworldXamarin/README.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/examples/csharp/HelloworldXamarin/README.md b/examples/csharp/HelloworldXamarin/README.md index 4394dcc0c43..7bbc8cc5e7a 100644 --- a/examples/csharp/HelloworldXamarin/README.md +++ b/examples/csharp/HelloworldXamarin/README.md @@ -6,23 +6,26 @@ 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. +source. +NOTE: To downlaod the package please manually [download](https://packages.grpc.io/archive/2018/07/a3b54ef90841ec45fe5e28f54245b7944d0904f9-d24c85c7-32ed-4924-b9af-80e7a4aeb34d/index.xml) the .nupkg file 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 +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 Xamarin Studio or Visual Studio 2017 with Xamarin support installed. +- The latest version Visual Studio for Mac or Visual Studio 2017 with Xamarin support installed. BUILD ------- -- Open the `HelloworldXamarin.sln` in Visual Studio (or Xamarin Studio) +- Open the `HelloworldXamarin.sln` in Visual Studio (or Visual Studio for Mac) - Build the solution (Build -> Build All) Try it! From 63ce61b4eb31e209cc9fbecfad1c1d48c1c5c633 Mon Sep 17 00:00:00 2001 From: jzeferino Date: Thu, 2 Aug 2018 21:37:43 +0100 Subject: [PATCH 2/3] Fixed typo. --- examples/csharp/HelloworldXamarin/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/examples/csharp/HelloworldXamarin/README.md b/examples/csharp/HelloworldXamarin/README.md index 7bbc8cc5e7a..d2f00a4d63a 100644 --- a/examples/csharp/HelloworldXamarin/README.md +++ b/examples/csharp/HelloworldXamarin/README.md @@ -7,7 +7,7 @@ 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. -NOTE: To downlaod the package please manually [download](https://packages.grpc.io/archive/2018/07/a3b54ef90841ec45fe5e28f54245b7944d0904f9-d24c85c7-32ed-4924-b9af-80e7a4aeb34d/index.xml) the .nupkg file 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. +NOTE: To download the package please manually [download](https://packages.grpc.io/archive/2018/07/a3b54ef90841ec45fe5e28f54245b7944d0904f9-d24c85c7-32ed-4924-b9af-80e7a4aeb34d/index.xml) the .nupkg file 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. From 7c0cd2915ed73948658c184c4f7a162d9babc4b3 Mon Sep 17 00:00:00 2001 From: Jan Tattermusch Date: Fri, 3 Aug 2018 13:07:27 +0200 Subject: [PATCH 3/3] HelloworldXamarin readme improvements --- examples/csharp/HelloworldXamarin/README.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/examples/csharp/HelloworldXamarin/README.md b/examples/csharp/HelloworldXamarin/README.md index d2f00a4d63a..e47855de5e1 100644 --- a/examples/csharp/HelloworldXamarin/README.md +++ b/examples/csharp/HelloworldXamarin/README.md @@ -6,10 +6,9 @@ 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. -NOTE: To download the package please manually [download](https://packages.grpc.io/archive/2018/07/a3b54ef90841ec45fe5e28f54245b7944d0904f9-d24c85c7-32ed-4924-b9af-80e7a4aeb34d/index.xml) the .nupkg file 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. - +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 ------------- @@ -20,7 +19,7 @@ For this sample, we've already generated the server and client stubs from [hello PREREQUISITES ------------- -- The latest version Visual Studio for Mac or Visual Studio 2017 with Xamarin support installed. +- The latest version Visual Studio 2017 or Visual Studio for Mac with Xamarin support installed. BUILD ------- @@ -31,7 +30,7 @@ BUILD Try it! ------- -You can deploy the example apps directly through Xamarin Studio IDE. +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).