umbrella header for module 'myFramework' does not include header 'otherFramework.h'

Objective CXcodeSwiftFrameworksCarthage

Objective C Problem Overview


My Swift / iOS9 framework 'viewer_protocol' uses another and external Objective-C framework (CocoaAsyncSocket). I'm using Carthage to build CocoaAsyncSocket. So far everything works fine: In have an example App inside my framework Xcode Project using my framework without any problems.

Now I want to use my Framework in a different Xcode Project - although using Carthage. I include only my Framework as a dependency and Carthage automatically resolves the dependencies to CocoaAsyncSocket. I embedded both frameworks into this new Xcode Project and build my App: Everything works fine here - except one warning I can't rid off:

/Users/John/Repositories/my_project/<module-includes>:1:1: 
Umbrella header for module 'my_project' does not include header 'GCDAsyncSocket.h'

This is my framework header:

#import <UIKit/UIKit.h>

//! Project version number for my_project.
FOUNDATION_EXPORT double my_projectVersionNumber;

//! Project version string for my_project.
FOUNDATION_EXPORT const unsigned char my_projectVersionString[];

// In this header, you should import all the public headers of your framework     
using statements like #import <my_project/PublicHeader.h>
#import <CocoaAsyncSocket/CocoaAsyncSocket.h>

As you can see CocoaAsyncSocket.h is imported. Furthermore inside my framework the CocoaAsyncSocket.h file is included:

my framework's folder

What I am missing here? I'm using several others external frameworks inside my framework, there're no warnings for them - all of these external frameworks are written in Swift - CocoaAsyncSocket is pure Objective-C.

This is my frameworks module.modulemap:

 framework module my_project {
   umbrella header "my_project.h"

   export *
   module * { export * }
 }

 module viewer_protocol.Swift {
     header "my_project-Swift.h"
 }

Update

I found a solution: Changing the import statement in my framework header from

#import <CocoaAsyncSocket/CocoaAsyncSocket.h>

to

#import "CocoaAsyncSocket/CocoaAsyncSocket.h"

Now Xcode finds the header file and the warning disappears.

Objective C Solutions


Solution 1 - Objective C

I recently ran into same issue. Apparently I had header file set as public in target membership, but it was not exposed in umbrella header. Fixed issue by making header file with project access instead of public.

Solution 2 - Objective C

I had the same issue today

> Umbrella header for module 'HockeySDK' does not include header 'BITHockeyBaseViewController.h'

and the solution was

1.build and run project and go-to Report Navigator

2.look at the warning, click to expand details

it will so you the file name where you need to make change as you can seen in below screen shot

enter image description here

So i just updated my import statement in AppDelegate.m file

New

#import "HockeySDK/HockeySDK.h"

Old

#import <HockeySDK/HockeySDK.h>

and issue gone..

hope this will help someone. who are coming here for solution.

Solution 3 - Objective C

I had the same issue. Seemed to be related to old build files.

The standard Xcode problem fixer worked for me:

  1. Clean project (Product > Clean Build Folder)
  2. Deleted derived data
  3. Restart Xcode

Solution 4 - Objective C

For me the solution was as follows:

  1. Each Objective C framework has 1 header file that contains all the:

    #import ... #import ... #import ...

  2. Make sure that this file imports the missing header.

  3. Build the project again, it should remove the warning.

Solution 5 - Objective C

Alternatively, you may have exposed files within the Public area of your framework's build phases that should actually be moved back to the Project area.

If you don't want those files to be within your framework's umbrella header so they're publicly accessible, you can revert this.

Goto Framework -> Target -> Build Phases and drag to move the unnecessary header files from Public to Project.

Screenshot

Solution 6 - Objective C

Just for completeness if your header is set to public in :

Build Phases > Headers

You should either

Include the import in your main header as others have mentioned

OR

Move that header to "private" if it doesn't need to be exposed

Solution 7 - Objective C

We got this recently and it was due to corruption in DerivedData. Deleting that folder fixed the problem.

Solution 8 - Objective C

For others : In my case I already move the headers I want to expose from my framework, from "project" to "public" (Build phases of the framework target)

Then Xcode gave my this warning.

Xcode is telling us that we also need to add #import "name of header in the warning> in the public header file that was created with framework, so the clients (of the framework) will know this header.

So The Fix:
1.go to the framework public header file.(the one what created by xcode when you created the framework) .

  1. add #import "the-name-of-the-header-in-the-warning.h"

Solution 9 - Objective C

In my case (Obj-c framework):

Umbrella header for module 'opus' does not include header 'opus_multistream.h'

I needed to change:

@import opus.opus_defines;

into

@import opus;

(I don't have in #import "....h" or #import <....h> for frameworks)

Solution 10 - Objective C

Take a look at this post:

https://stackoverflow.com/questions/18947516/import-vs-import-ios-7

It goes over the concepts of the new module importing. I had my own custom framework and after adopting the new method to import objective-c framework

old: #import <MyFramework/MyFramework.h>

new: @import MyFramework;

it took care of the warning/

Solution 11 - Objective C

trying to fix a archive build error led me to this error and post

my solution was real simple but took forever for me to figure out.

  • when i ran $ pod install it generated a workspace for me in the same dir as my .xcodeproj file.
  • however i had already created a workspace to use as its parent directory.
  • so then i simply deleted my old workspace and went with the one that pods created

enter image description here


hope this helps someone! glhf!

Solution 12 - Objective C

For me the fix was rather simple, commit all your changes and build again. The warning disappeared.

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionhibentoView Question on Stackoverflow
Solution 1 - Objective CAyJayView Answer on Stackoverflow
Solution 2 - Objective CswiftBoyView Answer on Stackoverflow
Solution 3 - Objective CSensefulView Answer on Stackoverflow
Solution 4 - Objective COded RegevView Answer on Stackoverflow
Solution 5 - Objective CiwasrobbedView Answer on Stackoverflow
Solution 6 - Objective CpflousView Answer on Stackoverflow
Solution 7 - Objective CAnneTheAgileView Answer on Stackoverflow
Solution 8 - Objective Cuser1105951View Answer on Stackoverflow
Solution 9 - Objective CszubiszonView Answer on Stackoverflow
Solution 10 - Objective Cmjl007View Answer on Stackoverflow
Solution 11 - Objective CgreenhouseView Answer on Stackoverflow
Solution 12 - Objective CjaroraView Answer on Stackoverflow