From 44d84b0013a16124d493ee409f41a1e4e1334ab6 Mon Sep 17 00:00:00 2001 From: Thomas Van Lenten Date: Tue, 10 May 2022 09:31:32 -0400 Subject: [PATCH] Add note about import statements following shuffling. --- README.md | 6 +++--- USING.md | 11 +++++++++++ 2 files changed, 14 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index a23e2b1c8..df5fe2541 100644 --- a/README.md +++ b/README.md @@ -13,9 +13,9 @@ framework for accessing JSON APIs. This is the recommended library for accessing JSON-based Google APIs for iOS, macOS, tvOS, and watchOS applications. -**To get started** with Google APIs and the Objective-C client library, Read the -[USING.md](https://github.com/google/google-api-objectivec-client-for-rest/blob/main/USING.md). -The +**To get started** with Google APIs and the Objective-C client library, please read +[USING.md](https://github.com/google/google-api-objectivec-client-for-rest/blob/main/USING.md) +for detailed information. The [example applications](https://github.com/google/google-api-objectivec-client-for-rest/tree/main/Examples) can also help answer some questions, but there isn't an example for every service as there are just to many services. diff --git a/USING.md b/USING.md index a63ddb3ed..f908e6e5a 100644 --- a/USING.md +++ b/USING.md @@ -83,6 +83,17 @@ If you are generating code for your own APIs, then add `GoogleAPIClientForRESTCore` to get the supporting runtime and then manually add the generated sources to your Xcode project. +### `#import`s and `@import`s + +Since CocoaPods and SwiftPM use different models for how things are built, the +module names for `@import` directives will be specific to each packaging system. + +However, if consuming this library via Objective-C, all the packages export +their headers as _GoogleAPIClientForREST/HEADER.h_, so you can always `#import` +them as a framework import and that will work with either packaging system, +i.e. - `#import