The New API for interfacing with FamilySearch using Apple technologies.
Clone NewDot into your project as a Git submodule, then clone the other sub-submodules that NewDot depends on:
git submodule add firstname.lastname@example.org:FSDEV/NewDot.git vendor/NewDot cd vendor/NewDot git submodule init git submodule update
From here you have two options: link to a Static Library, or copy file references into your project.
The static library is slightly more flexible, and allows you to hide the implementation of NewDot from your application promoting encapsulation. However, some testing has found that Xcode fails (badly) at discovering user headers. I don't have a definitive solution to fix the problem, though it is somewhat reproduceable.
In the event that you experience this, or just don't want to bother dealing with this potential failure, use the "File References" instructions.
Add the NewDot project to your Xcode project workspace; under your application's Build Phases tab, add "NewDot" as a Target Dependency. To your project add the linker flags
-all_load -ObjC to ensure that categories are loaded correctly. Finally, ensure that you add
$(BUILT_PRODUCTS_DIR) (non-recursive) to your User Header Search Paths.
You should now be linking against the NewDot library. The headers are accessed using a prefix. For example, if I wanted to import
NDService.h, I would import
Do not add the NewDot project to your Xcode project workspace. Instead, open the NewDot directory and drag the following files into your project from Finder:
Headers and Implementation (Grab both the
.m file of these)
NSData+StringValue(not actually required, but calling
NSDataduring debugging can be helpful)
From there you should be good to go. Be warned that your code may break when you update if I add new files (in which case you'll have to drag them into your project) or if I remove files (in which case you'll get red files in Xcode - just delete them and you should be good).
NewDot is licensed under the Firestorm Development Open-Source License. More information can be found in the file