Google Maps SDK for iOS requires GoogleMaps.bundle to be part of your target under 'Copy Bundle Resources

Question

When I build a GoogleMaps SDK for iOS,these error occurred.

*** Terminating app due to uncaught exception 'GMSException', reason: 'Google Maps SDK for iOS requires GoogleMaps.bundle to be part of your target under 'Copy Bundle Resources''

but,GoogleMaps.framework is in copy bundle resources.so,I'm confused.please tell me cause of this problem.

After adding GoogleMaps.bundle in GoogleMaps.framework to my copy bundle resource,all go well !! Thank you !! — JohnyDgoode, Feb 07 '13 at 06:27

score 182 · Accepted Answer · edited Dec 23 '22 at 09:05

182

The instructions are kinda lacking.

Launch Xcode (easy)
Drag the GoogleMaps.framework bundle to the Frameworks group of your project. When prompted, select Copy items into destination group's folder.
Right-click GoogleMaps.framework in your project, and select Show In Finder. What it doesn't say is...Then go into the child folder called Resources
Drag the GoogleMaps.bundle from the Resources folder to your project. We suggest putting it in the Frameworks group. When prompted, ensure Copy items into destination group’s folder is not selected.

edited Dec 23 '22 at 09:05

starball

20,030
7
43
238

answered Feb 20 '13 at 23:04

sberley

2,238
1
16
12

4

This is better instructions than mine ! Thank you ! – JohnyDgoode Feb 21 '13 at 07:08
Glad to hear it - were you able to get an API key that made the mapping work? – sberley Feb 21 '13 at 07:31
yep,but It took me a month to take an API key X( – JohnyDgoode Feb 22 '13 at 03:05
1

Your additions here are now reflected in the official docs here: https://developers.google.com/maps/documentation/ios/start#obtaining_an_api_key Perhaps someone at Google saw this post? – Mark Amery Jul 09 '13 at 08:53
3

I did this , my app crashes still – Lena Bru Jul 15 '14 at 13:19
Where is this child folder? – Tony Friz Oct 30 '14 at 16:22
I did this , my app crashes still and dosent seems there is a frameworks folder in Xcode 7 any more. – Ravi Dalmia Nov 02 '15 at 01:23
Still having the same problem :( – Tarun Seera Jul 25 '16 at 10:30
1

As said by @JohnyDgoode, after adding GoogleMaps.bundle in GoogleMaps.framework to my copy bundle resource, all went well! – Md Rais Dec 03 '16 at 07:40
Saved me 2 days !! This is what good documentation should have said on the first place! Anyhow, cheers ! – Hassan Abbas Jan 21 '19 at 14:40
And also `libz.tbd` and `libc++.tbd` is needed to add to `Link Binary With Library` section. [Google Docs](https://developers.google.com/maps/documentation/ios-sdk/start#step_2_install_the_sdk). – Lal Krishna Mar 13 '19 at 09:44

score 90 · Answer 2 · answered Aug 10 '17 at 08:00

90

To the 2017 people searching on SO, the easiest way is indeed try the installing and updating your pod by of course pod install and pod update. Then finally, clean the project and the build by these two commands:

Clean Build: Command + alt option + Shift + K
Clean Project: Command + Shift + K

Then voila! Crash won't happen again.

answered Aug 10 '17 at 08:00

Glenn Posadas

12,555
6
54
95

4

Oh wow, thanks myself! Happened to me again in Xcode 9.0 beta 2. – Glenn Posadas Aug 22 '17 at 17:49
Also, clear derived data. Seems to help. xCode -> Preferences -> Locations then click the little arrow next to the derived data path. Move the folder that pops up in finder to the trash. – Jon Vogel Oct 18 '17 at 18:11
@Glenn After every time I make the change in storyboard and change its localized text. Map crashes. Is there any solution? – nikdange_me Nov 14 '17 at 20:28
@nikdange_me Hmm not sure, but have you tried this answer? Just clean your project everytime you change your localized text? OR perhaps post a new question. – Glenn Posadas Nov 15 '17 at 05:10
@Glenn I tried your answer, it works. I have to do it every time I change storyboard and localize its text. I have to do 'pod install' n 'update'. Is there any solution to fix it *once*? btw thanks. :) – nikdange_me Nov 15 '17 at 06:13
3

Yes it helps, but after a while this error is repeated again. – Alexander Khitev Nov 27 '17 at 10:35

RedBlueThing · Answer 3 · 2015-11-24T02:39:12.090

8

If you are experiencing this issue in a more recent version of this framework and are using the CocoaPods deployment, then check that the "Copy Pods Resources" section of "Build Phases":

Apparently this section going missing is a thing and deleting your Pods directory and re-running "pod install" isn't sufficient to fix it. Instead you will need to grab this handy tool:

https://github.com/CocoaPods/cocoapods-deintegrate

Run this thing and then re run pod install and your "Copy Pods Resources" section should be back and you won't get this exception when you instantiate your map.

edited Nov 24 '15 at 02:39

answered Nov 24 '15 at 02:32

RedBlueThing

42,006
17
96
122

1

i already have this section in Build phases, but map is sill not working – sandeep tomar Jan 15 '16 at 10:07
Sorry @sandeeptomar I guess your problem must be something else. – RedBlueThing Jan 16 '16 at 11:53
Copy Pods Resources can go missing indeed, and pod reintegrate didn't fix it for me. I created a new project, did a pod install with the relevant pod, then copied the pod resources script over – RyanM Mar 22 '16 at 04:21
Thanks @RedBlueThing. my problem is resolved with this trick. I could see "Copy Pods Resources" section again. deintegrate is a great tool. thanks – Manish Nahar May 30 '20 at 10:36

score 7 · Answer 4 · edited Dec 07 '17 at 02:26

For those of you trying this out in 2017 with Xcode 9 (first release) and the new build system, the following resolved this for me.

Note: The fundamental issue seems to be that the new build system is NOT cleaning properly, so you need to switch back to the old system. Also as of 9/25/17 the google place picker is calling UI off the main thread and is throwing errors in Xcode.

-Switch to old build system

-click your project file "My App Name"

-Under "TARGETS" click your app name (not tests or UITests!)

-build phases

-[CP] Copy Pods Resources

-You should see ${PODS_ROOT}/GoogleSomething , select those and hit -

-Close Xcode, run pod install.

-Open Xcode, Command-Shift-K (clean, and MAKE SURE YOU'RE ON THE OLD BUILD SYSTEM!)

-Build/Run, should work now

This was the only one that worked for me out of all the other answers — Jan, Nov 27 '17 at 18:30

Abdul Hannan · Answer 5 · 2017-06-27T06:15:01.993

4

running "pod install" fixed this issue for me.

edited Jun 27 '17 at 06:15

answered Mar 22 '17 at 11:36

Abdul Hannan

243
2
9

score 4 · Answer 6 · answered Dec 28 '17 at 06:49

4

If you installed the map via CocoaPods Try the following steps.

Go to TARGETS > Build Phases
Disable 'Run script only when installing'

answered Dec 28 '17 at 06:49

Sreeraj VR

1,524
19
35

Murugan M · Answer 7 · 2019-02-22T12:58:41.457

3

For Me i have the same issue in the manual installation.

1.right-click GoogleMaps.framework in your project, and select Show In Finder .

double click or Open this GoogleMaps.framework. we can able to see the Folder "Resources" . (i have added the image Screen Shot for the where GoogleMaps.bundle available)
click the Resources folder we can find the GoogleMaps.bundle

now just Drag and Drop the GoogleMaps.bundle into your project. ensure Copy items into destination group’s folder is not selected.

Note: ensure "Copy items if Needed" destination group’s folder is not selected. see the Screen shot too.

now Clean the Command+Shift+K or Xcode-->Product--> Clean

this may helps to someone.

edited Feb 22 '19 at 12:58

answered Jul 03 '18 at 12:20

Murugan M

175
3
8

What do you mean by "track into your project"? – Farid Feb 03 '19 at 16:51
1

sorry @FARID this is "drag and drop" into your project – Murugan M Feb 04 '19 at 05:40

score 2 · Answer 8 · answered May 14 '18 at 07:05

2

I was facing same issue, do the following:

1. Go to derived folder and delete the project folder
2. Clean build and run

Fixed the issue

answered May 14 '18 at 07:05

sahiljain

2,215
1
29
39

score 1 · Answer 9 · answered Jun 18 '17 at 02:16

Terminating app due to uncaught exception 'GMSException', reason: 'Google Maps SDK for iOS requires GoogleMaps.bundle to be part of your target under 'Copy Bundle Resources'

find GoogleMaps.bundle in GoogleMap.frameword/Resources you will see GoogleMap.bundle
Drag GoogleMaps.bundle into Base/Framework with GoogleMapsBase.framework

hope this can help. Thanks

Lance Samaria · Answer 10 · 2018-02-14T23:45:02.290

Once I updated to Xcode 9 Swift 3.2 I kept getting a crash inside AppDelegate at this line:

GMSServices.openSourceLicenseInfo()

I kept using Glenn's answer to clean the project which definitely worked but eventually the crash kept happening.

To solve it I had to follow the directions in Google Maps API Installation

Follow:

Step 2: Install the SDK and Install Manually

This is very easy to do but 1 thing sort of confused me at first so I'm adding it in for clarity for the next person:

Once your read the manual instructions and on number 4 it says:

4. Drag the following bundles into your project (when prompted, select Copy items if needed):

The thing is inside the zip file that you download, once you unpack it there are only going be 2 frameworks inside of it:

GoogleMaps.framework
GoogleMapsCore.framework

There won't be a GoogleMapsBase.framework. I'm assuming they bundled it into the GoogleMaps.framework?

Once you get to number 8: Open the Build Phases tab, and within Link Binary with Libraries, add the following frameworks:. It lists a number of frameworks that you have to import.

The problem is the first 3 that are listed that it says to add were already added (actually two of them were added -GoogleMaps.framework and GoogleMapsCore.framework) when you unpacked that zip file and dragged them into your project.

I kept typing in the names and nothing would show up.

I kept deleting all the Google frameworks, starting from the beginning, and trying again until I realized they already existed. Basically type in the names of everything from Accelerate.framework - UIKit.framework and you should be good.

score 0 · Answer 11 · answered Jan 04 '20 at 15:33

0

This way I have fixed my issue.

 1. Delete the derived folder.
 2. pod update
 3. Clean Project and build.

Thats all

answered Jan 04 '20 at 15:33

Tunvir Rahman Tusher

6,421
2
37
32

Google Maps SDK for iOS requires GoogleMaps.bundle to be part of your target under 'Copy Bundle Resources

11 Answers11

Linked