Moving gRPC Swift 2 to a new repository

[georgebarnett]

In order to facilitate the incremental migration from gRPC Swift 1 to gRPC Swift 2 the code for version 2 will be moving to a new repository on GitHub.

This will allow existing users of gRPC Swift to depend on version 1 and version 2 in the same package graph allowing for a more gradual migration.

Existing users of gRPC Swift 2 will have to do a small amount of work to update their dependencies. The changes being made are detailed below.

Changes

• The existing code for version 2 in the grpc/grpc-swift repository will move to a new repository called grpc/grpc-swift-2.
• The Swift package in the new repository will be renamed from "grpc-swift" to "grpc-swift-2".
• The initial release of the new package will 2.0.0, this will be equivalent to version 2.2.2 of grpc/grpc-swift.
• grpc/grpc-swift-protobuf, grpc/grpc-swift-nio-transport, and grpc/grpc-swift-extras will be updated to depend on grpc/grpc-swift-2. Doing so will require bumping their major versions, with each being tagged as 2.0.0.
• protoc-gen-grpc-swift will be renamed to protoc-gen-grpc-swift-2 in order to allow gRPC Swift 1 to be built in the same package graph as gRPC Swift Protobuf.
• A final patch release of the 2.x series for grpc/grpc-swift and the 1.x series for each of grpc/grpc-swift-protobuf, grpc/grpc-swift-nio-transport, and grpc/grpc-swift-extras will deprecate major types with a message linking to this post.

What you need to do

If you're using gRPC Swift 2 then you'll need to take the following steps:

1. Change the "grpc-swift" package dependency to "grpc-swift-2" and its version requirement to from: "2.0.0" in your package manifest (Package.swift).
2. Change the package name for target depencies from "grpc-swift" to "grpc-swift-2".
3. Change the version requirement for "grpc-swift-protobuf" to from: "2.0.0" (if applicable)
4. Change the version requirement for "grpc-swift-nio-transport" to from: "2.0.0" (if applicable)
5. Change the version requirement for "grpc-swift-extras" to from: "2.0.0" (if applicable)
6. Update any scripts relying on protoc-gen-grpc-swift to use protoc-gen-grpc-swift-2. (if applicable)

When will these changes be made?

These changes will be made over the next few days. The final patch release of the 2.x series will be made in the week commencing 2nd June at which point it's advisable to move to the new versions.

[dima_kozhinov (Dmitry Kozhinov)]

On your official site grpc.io Swift is not mentioned at all (?) Supported languages | gRPC Why is that?

[georgebarnett]

We've been waiting to do the repo change so that the links and docs there aren't immediately outdated.

[georgebarnett]

Update

All repos have now rolled over to using grpc-swift-2 and new versions of each have been tagged:

• grpc/grpc-swift-2: 2.0.0
• grpc/grpc-swift-protobuf: 2.0.0
• grpc/grpc-swift-nio-transport: 2.0.0
• grpc/grpc-swift-extras: 2.0.0

[jessezamora]

How will this work if your project depends on grpc-swift-protobuf v1 and grpc-swift-protobuf v2? Do these perhaps not conflict if you use grpc-swift-protobuf v2 for example with grpc-swift v1?

[0xTim (Tim)]

grpc-swift-protobuf has always only ever depended on gRPC Swift v2, so there's no risk of conflicts there if you want to use both v1 and v2