Create migration guide for rules_swift 2.x

bazelbuild / rules_swift

Bazel rules to build Swift on Apple and Linux platforms

Apache License 2.0

309 stars 133 forks source link

Create migration guide for rules_swift 2.x #1230

Open luispadron opened 2 months ago

luispadron commented 2 months ago

rules_swift 2.x (soon to be released) will be a major version with a few breaking changes. We should document the breaking changes and offer guidance on going from 1.x to 2.x for users and rule authors.

luispadron commented 2 months ago

Some things I can think of we should go over:

Removal of swift.emit_symbol_graph feature, we should point users to the new swift_symbol_graph_extract rule.
Changes to C/C++/Objective-C module name determination, we should point users to the new swift_interop_hint rule and use of aspect_hints.

brentleyjones commented 2 months ago

Removal of the deprecated grpc/proto rules.

brentleyjones commented 2 months ago

I'm going to cherry-pick https://github.com/bazelbuild/rules_swift/commit/57cdd762d4b2e49311c4595b6e1149fef553cfef, so we should tell people to use the new load statements (though not a breaking change yet, the old way will only be deprecated for now).

aaronsky commented 2 months ago

Removal of swift_c_module as the rule is redundant with swift_interop_hint's featureset

brentleyjones commented 2 months ago

swift.disable_system_index is now enabled by default

brentleyjones commented 2 months ago

Removed swift.bundled_xctests and swift.use_response_files.