IOS Static Framework with resources inside - ios

I'm trying to create a framework that keeps some common code I use around in my projects.
I found online tutorials and managed to create a framework but I still have one problem related to resources (xibs, images, etc).
Let's say I have a MainViewController.xib which has a UIImageView using a test.png. All these are in my framework package.
When I use the framework in another project, I add it to the "Copy Bundle Resources" build phase. The problem is that the xib is only accessible using a path like dummy.framework/Resources/MainViewController.xib and the UIImageView inside can't load test.png.
It seems that the UIImageView will try to load the png from the root of the bundle, and not from the relative folder where the xib is also stored.
Has anybody managed to create a framework with code and resources and use it in another project?

I know this is an old thread, but to keep new people from making the same mistakes here is a note:
As of Xcode 6 and iOS8, Apple has a fully supported first party Dynamic Framework solution built in. For more information look here: https://developer.apple.com/library/ios/documentation/DeveloperTools/Conceptual/WhatsNewXcode/Articles/xcode_6_0.html#//apple_ref/doc/uid/TP40014509-SW14
But the short of it is, create a new project and choose the Cocoa Touch Framework template.

I created a framework target and to access images inside its asset catalog I did the following:
UIImage *img = [UIImage imageNamed:#"IMAGE_NAME_HERE" inBundle:[NSBundle bundleForClass:[self class]] compatibleWithTraitCollection:[UITraitCollection traitCollectionWithDisplayScale:[UIScreen mainScreen].scale]];

I don't manually manage frameworks anymore but use and recommend CocoaPods instead.
Original answer:
Use the fake framework #wattson12 mentioned. It will compile and save the resources as well.
Inspired by this script, add this to your target to copy the resources to your app:
SOURCE_PATH="${TARGET_BUILD_DIR}/MYFramework.framework/Resources/"
TARGET_PATH="${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/MYFrameworkResources.bundle"
mkdir -p $TARGET_PATH
cp -R $SOURCE_PATH $TARGET_PATH
You could also just drag the framework to your Copy Resources step, but then you'll be adding unnecessary headers and compiled code as well.
Edit
To use these resources from IB, for instance a png file, replace:
MyImage
by:
MYFrameworkResources.bundle/MyImage.png
It will preview a broken image icon but will work when running.
Load a Nib from code:
[NSBundle loadNibNamed:#"MYFrameworkResources.bundle/MyNib" ...
Finally you can add these methods in a NSBundle category to ease access to Nib resources that my be in your main bundle or in MYFrameworkResources.bundle:
#implementation NSBundle (MyCategory)
+ (NSString *)pathForResource:(NSString *)name
ofType:(NSString *)extension
{
// First try with the main bundle
NSBundle * mainBundle = [NSBundle mainBundle];
NSString * path = [mainBundle pathForResource:name
ofType:extension];
if (path)
{
return path;
}
// Otherwise try with other bundles
NSBundle * bundle;
for (NSString * bundlePath in [mainBundle pathsForResourcesOfType:#"bundle"
inDirectory:nil])
{
bundle = [NSBundle bundleWithPath:bundlePath];
path = [bundle pathForResource:name
ofType:extension];
if (path)
{
return path;
}
}
NSLog(#"No path found for: %# (.%#)", name, extension);
return nil;
}
+ (NSArray *)loadNibNamed:(NSString *)name
owner:(id)owner
options:(NSDictionary *)options
{
// First try with the main bundle
NSBundle * mainBundle = [NSBundle mainBundle];
if ([mainBundle pathForResource:name
ofType:#"nib"])
{
NSLog(#"Loaded Nib named: '%#' from mainBundle", name);
return [mainBundle loadNibNamed:name
owner:owner
options:options];
}
// Otherwise try with other bundles
NSBundle * bundle;
for (NSString * bundlePath in [mainBundle pathsForResourcesOfType:#"bundle"
inDirectory:nil])
{
bundle = [NSBundle bundleWithPath:bundlePath];
if ([bundle pathForResource:name
ofType:#"nib"])
{
NSLog(#"Loaded Nib named: '%#' from bundle: '%#' ", name, bundle.bundleIdentifier);
return [bundle loadNibNamed:name
owner:owner
options:options];
}
}
NSLog(#"Couldn't load Nib named: %#", name);
return nil;
}
#end
It will first look into your application bundle and then in MYFrameworkResources.bundle, etc.

In order to load an image from a dynamic framework in Swift 3:
UIImage(named: "name", in: Bundle(for: type(of: self)), compatibleWith: nil)

Basic frameworks do not include most kinds of resources, to include resources use this "fake" framework library
You end up with a .embeddedframework folder which contains the actual framework, but also includes any resources which you add to the Copy Bundle Resources build phase. Ive used it to include xibs, core data models, images, and plists

Short answer: you can't.
When you compile the app, the bundle is generated with the resources of the "main" project, ignoring the resources in linked frameworks. This includes images, xib's, plist's, etc. (anything that isn't a source file)
What you need to do is add those resources to your main project so that they are available for use inside your application, not the happiest way around it but it'll work.

As of Xcode 7 we can now use Asset Catalogs. In my experiments I've found that u can reference files in the same workspace bit different projects removing the need to micro manage assets in build phases or worrying about targets.

Related

How to make Cocoapods to generate a bundle file

So I am creating an iOS static library project that will also support Cocoapods.
This library project will contain js files which you need to ship in a bundle (It won't compile into .a file). In the code, the way I reference these js files are, finding the bundle file first, then get the file from bundle. This works.
NSBundle *bundle = [NSBundle bundleWithURL:[
[NSBundle mainBundle] URLForResource:#"resource" withExtension:#"bundle"]];
NSString* html = [bundle pathForResource:#"foo" ofType:#"js"];
However, in Cocoapods distrubtion, these resource files are configured using
s.ios.resource_bundle = {
'resources' => ['foo.js']
}
And in code, you need to reference it by
[NSBundle mainBundle] pathForResource:...
There will be no custom bundle(resource.bundle) file anymore, all will be merged in mainBundle
Is there an universal way to references these js files? Thanks!

How to retrieve a file/resource in a iOS framework bundle from a main program?

I use methods about creating a universal binary framework for iOS development to distribute a library. I would also like to add files in the framework, and load them in the main program (an SSL certificate actually). This is related to this StackOverflow question, the main difference is that I want to include something else than a XIB.
If we read the thread related to the linked post, it seems it is not possible. However, the following blog article was mentioned; we can read:
"Static frameworks are not a full replacement for standard frameworks
-- standard methods for accessing the framework resources, such as +[NSBundle bundleForClass:] will not return the expected bundle. The bundle path is determined by querying dyld for the library path
corresponding to the symbol address -- In the case of static linking,
this will return the path to the binary into which the static library
was linked. Additionally, NSBundle/CFBundle will examine the previous
stack from for the return address, and use that return address to
determine the calling code's dyld binary path. Given these
restrictions, some work-arounds are possible, such as using -[NSBundle privateFrameworkPath]
to locate the path to the embedded framework."
I am a beginner in iOS development, and I struggle in using such a mechanism. Using the privateFrameworksPath returns a path indeed, but I do not know what to do next to locate the file I want to load.
It is something like that:
NSBundle * bundle = [NSBundle bundleForClass:[self class]];
NSString * path = [bundle privateFrameworksPath]; // Works, return something like .../Frameworks
NSString * file = [path stringByAppendingPathComponent:#"MyFramework.framework/Versions/A/my-cert.der"];
NSData * trustedCertData = [NSData dataWithContentsOfFile:file]; // Returns nil
Any ideas?
The following code worked for me in a similar case
NSBundle * bundle = [NSBundle bundleForClass:[self class]];
NSString * file = [bundle pathForResource:#"my-cert" ofType:#"der"];;
NSData * trustedCertData = [NSData dataWithContentsOfFile:[file stringByReplacingPercentEscapesUsingEncoding:NSUTF8StringEncoding]];
The NSBundle bundleForClass: method returns a bundle for the framework of the current class. So if you call this method from within MyFramework you won't need to append the path with MyFramework.framework again, but you would have caught that debugging if that was your problem.
Also the dash in my-cert.der may need to be replaced with the % equivelent. hence the stringByReplacingPercentEscapesUsingEncoding: call.
Access to Framework bundle
The key point is to pass any metatype[About] of class which belongs to framework
Objective-C
NSBundle *someBundle = [NSBundle bundleForClass:[SomeFrameworkClass class]];
Swift
//via public framework's class
let frameworkBundle = Bundle(for: SomeFrameworkClass.self)
//or via Bundle Identifier(PRODUCT_BUNDLE_IDENTIFIER)
let frameworkBundle = Bundle(identifier: "com.someid")
//or if it is called from the framework
let frameworkBundle = Bundle(for: type(of: self))
let frameworkBundle = Bundle(for: Self.self)
//working with bundle as usual
[Vocabulary]

How can I load an image from Assets.car (compiled version of xcassets) within an NSBundle? (without using CocoaPods)

We're getting these kind of error messages:
Could not load the "iconStatus" image referenced from a nib in the bundle with identifier "com.company.OurResourceBundle".
Basically, we put a bunch of images in the xcassets folder ( which works for non-bundle loaded cases ). The xcassets and nib files are packed into a resource bundle.
When the app launches,
uiimageview in the nib file cannot load any images with the above error message.
[UIImage imageNamed:#"OurResourceBundle.bundle/iconStatus"] returns nil
The question is related to "How can I load an image from Assets.car (compiled version of xcassets) within an NSBundle?", but we don't use CocoaPods.
In iOS 7 it is not possible to load images from any .car file aside from the one that Xcode compiles into the main bundle. This was confirmed by an Apple Developer at https://devforums.apple.com/message/968859#968859:
Unfortunately it is not possible to load images from any car file aside from the one that Xcode compiles into your main bundle, as +imageNamed: does not accept a bundle parameter, which is what is needed to do so (and even then it would only be able to open a single asset catalog in a single bundle).
In iOS 8 there is a new method that appears to do what you want:
+ (UIImage *)imageNamed:(NSString *)name inBundle:(NSBundle *)bundle
compatibleWithTraitCollection:(UITraitCollection *)traitCollection
you have to define your bundle
imageView.image = UIImage(named: "iconName", in: Bundle.main, compatibleWith: nil)
I suspect if your image assets folder gets compressed into a .car file then NSBundle will know how to search for assets inside of it. Try creating a new bundle from your resources bundle. Then ask that bundle for the path of your image. Finally create an image from that path. This is sort of the approach we take when bundling image assets and localized strings with our static libraries. Our version is a little more involved as it takes care of things like #2x and ~ipad images automatically but this is the gist of it.
NSBundle *myBundle = [NSBundle bundleWithPath:[[NSBundle mainBundle] pathForResource:#"your bundle" ofType:#"bundle"]];
NSString *filePath = [myBundle pathForResource:#"icon" ofType:#"png"];
UIImage *image = [UIImage imageWithContentsOfFile:filePath];

How to transfer resource files with Static Library (How to wrap resources in bundle)?

I'm creating a Static Library for iOS applications. I almost completed it, but there is an issue with the resources.
My Static Library uses a lot of images and sound files. How can I transfer it with my Static Library ?
I know we can wrap it on a bundle and give it along the .a file. But I don't know how to wrap Images and sound files in a Bundle file.
What I did:
I searched a lot, but couldn't find any useful links.
I got Conceptual CFBundles reference, but didn't find any solution for my problem.
I checked the file templates available for XCode, but didn't saw any bundle type other than Settings Bundle.
There are several good reasons to build an application with multiple bundles and several different ways to do it. To my experience the best way is open Xcode and create a new bundle project:
Select: File -> New Project… -> Group Mac OSX (!) -> Framework & Library -> Bundle. Add your resource files to the project.
Build the bundle as you build other iPhone apps.
You may add this project to your static library project and rebuild it all the time the library is changed. You must know that the bundle itself will not be linked to your library file.
In your app projects add the .bundle file to your project as an ordinary resource file (Add -> Existing Files… -> find and select the above built .bundle file. Do not copy it).
Example :
// Static library code:
#define MYBUNDLE_NAME #"MyResources.bundle"
#define MYBUNDLE_IDENTIFIER #"eu.oaktree-ce.MyResources"
#define MYBUNDLE_PATH [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent: MYBUNDLE_NAME]
#define MYBUNDLE [NSBundle bundleWithPath: MYBUNDLE_PATH]
// Get an image file from your "static library" bundle:
- (NSString *) getMyBundlePathFor: (NSString *) filename
{
NSBundle *libBundle = MYBUNDLE;
if( libBundle && filename ){
return [[libBundle resourcePath] stringByAppendingPathComponent: filename];
}
return nil;
}
// .....
// Get an image file named info.png from the custom bundle
UIImage *imageFromMyBundle = [UIImage imageWithContentsOfFile: [self getMyBundlePathFor: #"info.png"] ];
For more help you can check these good articles
iOS Library With Resources
Resource Bundles
Hope it helps you.

iOS Static Library with Image resources

I have a static library where I need some graphics resources as Images.
In my class I would to add an image in this way:
[UIImage imageNamed:#"myImage.png"]
but it not work...
how can I do it?
You can't provide anything other than code with a static library. This is because .a files are a simple archive of object files, with the added ability under Mac/iOS of supporting multiple CPU architectures.
The only option you have is to create a Framework, which can provide code as well as other resources.
Once you have that bundle, you can access to the resources you have there like this:
NSString *bundlePath = [[NSBundle mainBundle] pathForResource:#"YourBundle" ofType:#"bundle"];
NSString *imagePath = [[NSBundle bundleWithPath:bundlePath] pathForResource:#"yourImage" ofType:#"png"];
UIImage *image= [[UIImage alloc] initWithContentsOfFile:imagePath];
In Xcode, if you link a static library, the code from the library is included directly into your executable. No files are copied to the application bundle, so there's no way to copy the image.
If you have the image file with your static library, you can simply copy it to your application bundle by adding a copy files build phase to your target in Xcode.
I found the solution ..
I explored the bundles directory (compiled) and I've noticed that my images (.png) they had all the iestensione .tiff
To avoid this I set the key HIDPI_COMBINE_IMAGES in my bundle buid setting as NO
..so I can recover my pictures as suggested by e1985
Make a Framework target, not static library.
Make sure "Copy Bundle Resources" exists in Build Phases for your Framework. Add your resource files there.
Then to find the file in the Framework bundle from an outside project I just do this:
NSArray<NSBundle *> * bundles = [NSBundle allFrameworks];
NSString * filePath;
for (int i = 0; i < bundles.count; i++) {
filePath = [[bundles objectAtIndex:i] pathForResource:#"picture" ofType:#"png"];
if (filePath != nil) break; // found
}

Resources