Tag Archives: xcode

Import another project/framework (ADAL) into your project

May 11, 2016C/C++/Objective-C, ConfigurationsAzure, xcodeadmin

ref – http://www.insert.io/frameworkios8xcode6/

Let’s say we want to get a project called ADAL from the git repository and then add it to our project as an external framework for us to use.

First, let’s get the project:

git submodule add https://github.com/AzureAD/azure-activedirectory-library-for-objc adal
cd adal
git checkout tags/2.1.0

Optionally, later don’t forget to add this framework to your git, and push it.

cd ..
git add adal
git commit -m “Use ADAL git submodule at 2.1.0”
git push

Locate the ADAL project folder

the adal folder will be downloaded into your root git directory. (the one with the .git hidden folder)
You will see the ADAL project. Inside, you’ll see several folders. Locate the main ADAL folder with the source files by looking for a .xcodeproj file, along with src folder and its header/implementation files.

Drag the project over

Make sure you drag the .xcodeproj file over to your project space. Open it and you’ll see the src folders and what not. Look in the Products folder. You will see the ADAL.framework. That is what we’ll be importing into our project.

Select your Target, then Build Phases, then click on Link Binary With Libraries

Also, in Target, then Build Phases, then Target Dependencies, make sure you add the ADAL framework as well

Click on the ADAL framework and import it.

Make sure you’ve imported the framework. The run the project.

Inserting some code

Finally, in your ViewControllelr.m, import the header file and you should get no errors.

#import <MicrosoftAzureMobile/MicrosoftAzureMobile.h>

#import "QSTodoService.h"

#import <ADAL/ADAuthenticationContext.h>

#import <ADAL/ADAuthenticationResult.h>

#import <ADAL/ADTokenCacheItem.h>

add some define strings for the table names in our azure cloud

1 2	#define ALL_ACTIVITIES_TABLENAME @"TodoItem" #define ALL_ACTIVITIES_QUERID @"allTodoItems"

Let’s create a service so the view controller can communicate with the cloud tables

@interface LoginViewController ()<UITextFieldDelegate>

@property (strong, nonatomic) QSTodoService * todoService;

@end

Set up the service with the table name and query

- (void)viewDidLoad {

[super viewDidLoad];

self.todoService = [QSTodoService defaultService];

[self.todoService syncTableWithName: ALL_ACTIVITIES_TABLENAME];

[self.todoService setQuery: ALL_ACTIVITIES_QUERID];

}

- (void) loginAndGetData

{

//get client of our service that communicates with the table on the cloud on a query

MSClient * client = self.todoService.client;

if (client.currentUser != nil) {

return;

}

NSString *authority = @"<INSERT-AUTHORITY-HERE>";

NSString *resourceURI = @"<INSERT-RESOURCE-URI-HERE>";

NSString *clientID = @"<INSERT-CLIENT-ID-HERE>";

NSString *redirectURI = @"<INSERT-REDIRECT-URI-HERE>";

ADAuthenticationError *error;

ADAuthenticationContext *authContext = [ADAuthenticationContext authenticationContextWithAuthority:authority error:&error];

NSURL *redirectUri = [[NSURL alloc]initWithString:redirectURI];

[authContext acquireTokenWithResource:resourceURI

clientId:clientID

redirectUri:redirectUri

completionBlock:^(ADAuthenticationResult * result) {

if (result.tokenCacheItem == nil) {

return;

}

else {

NSDictionary *payload = @{@"access_token" : result.tokenCacheItem.accessToken};

[client loginWithProvider:@"windowsazureactivedirectory" token:payload completion:^(MSUser *user, NSError *error) {

[self refresh];

}];

}

}];

}

dyld: Library not loaded

http://stackoverflow.com/questions/24993752/os-x-framework-library-not-loaded-image-not-found

After you’d made sure there are no errors, if you run into an image not found error, it just means that in your Target, General, Embedded Binaries, click the ‘+’ button and add the ADAL ios framework from its original directory. (NOT the one you dragged into your project)

debugging with xCode (pt 5) – conditional debugging

June 13, 2015Configurations, iOSdebugging, xcodeadmin

Conditional

As you’re debugging your app, it may take in user input, for example, a gift name that’s a string.

Hence, code wise we want to say “if gift.name is equal to ‘xbox'”.

If you want to break whenever this string is equal to say “xbox”, you can do so using conditional debugging.

Edit the breakpoint and at the Condition textbox input the code:

1	expr (BOOL) [gift.name isEqualToString:@"xbox"]

The expression must evaluate to something so we simply cast it to BOOL.

Now, if you were to go back to your app and input xbox into the gift.name textfield, the runtime compiler will break to this line.

set

So now that the user have just entered “xbox”, we reach to this breakpoint. Let’s say we want to set this variable to something else instead, say “ps3”.

You simply add in an Action with the Debugger Command and insert the expression:

1	expr (void) [gift setName:@"PS3"]

Again, we’re telling the debugger this is an expression and thus must evaluate to something. Since its a set command, we just cast it void.

Therefore, we’re basically saying if the user enters a string gift.name that matches “xbox”, we want to change gift.name to “ps3” instead.

use the code’s setter method to set gift.name to ps3 in Action >> Debugger Command‘s textfield

1	expr (void) [gift setName:@"ps3"]

Now when you start the app and input “xbox”, it’ll jump to that breakpoint. While the program is paused, in your variable section, right click and select “Add Expression”. Put gift.name.

Then, have the debugger step down 1 line (fn + F6) so that you process the line of code. In your variable section, you will see that our expression gift.name was indeed changed to “ps3”.

debugging with xCode (pt 3) – Logging with break points

June 13, 2015C/C++/Objective-C, Configurations, iOSdebugging, xcodeadmin

Logging with Breakpoints

Say at a certain line in your code, you want to log some statements. You do so by first adding a breakpoint by clicking on the vertical strip of space on the left side of your source file. Then you right click on your breakpoint and select ‘edit break point’.

For option Action, select Log Message and type in some message you would like to appear. For example, the name of the file would be a good choice. Also, the name of the method you’re in is also another great choice. You do so by using %B.

You can also log custom variables by putting variables in between %%

Now, execution will stop at your breakpoint and print out your log messages

However, say you want the execution to keep going. You’d check the “Automatically continue…” checkbox so that you get the logging and all that, but execution continues.

Now it just uses your breakpoint to do whatever Action you intended and continues on to the next one.

Voice Logging

Next to Action, there is a + and – button. Use the + button to add more actions. Select Log Message and there is a Speak Message option. Select it and it will voice your logs.

Debugger Command

Add a breakpoint on a line right beneath a variable say:

int i, j=3;

DataStore *dataStore = [DataStore sharedDataStore];

//add the breakpoint here

Control click or right click the breakpoint, click ‘Edit Breakpoint’, then select select “Debugger Command” from the dropdown. In the text field type the follow:

1	po yourVariableName

po is a debugger command that will print out the contents of an object. You can keep adding Actions >> Debugger Command and po-ing variables.

Logging with Date

Action >> Debugging command

1	expr (void)NSLog(@"dataStore: %@", dataStore)

The expr command will evaluate an expression in real time. The expression command needs to know the actual type of the returning value, so a cast is necessary. Since there is no return type for NSLog, the return type is cast to a void value. Build and run.

You should now see the following:

2012-12-20 08:57:39.942 GiftLister[1984:11603] dataStore:

Being able to add NSLog messages via. breakpoints means you no longer have to stop the program just to log important data, there’s no chance of introducing new bugs because you are not touching the code, but best of all, there’s no last minute scrambles to remove all your debug statements the night before release.

Disabling breakpoints before a release

Say you’re ready to turn in a release and you want to disable all the breakpoint logging. Simply go to your navigator and press the debug section. Then select ‘Disable breakpoints’ and that’s it. Now your code will run without all the breakpoint logging.

debugging with xCode (pt 2) – stopping at exceptions

June 13, 2015C/C++/Objective-C, Configurations, iOSdebugging, xcodeadmin

Stopping at Exceptions

By default, when you run into an error, you’ll get a SIGART error that really does not tell us anything.

Currently, you cannot see the source of the compile error. To find it, you need to add an exception breakpoint to track down the source of the error.

So switch to the breakpoint navigator as shown below

The Exception field gives you the option of activating the breakpoint in Objective-C, C++, or All. Keep the default option of All.

The Break field in the dropdown allows you to pause execution on whether an error is thrown or caught. Keep it selected on thrown. If you are actually making use of exception handling in your code, then select ‘On Catch’. For the purposes of this tutorial, leave it ‘On Throw’.

Now you’ll be able to see where the error occured.

debugging with xCode (pt 1) – showing variables

June 12, 2015C/C++/Objective-C, iOSdebugging, xcodeadmin

Showing Variables

Your debugging console can be toggled by the middle button on the top right hand corner. Mainly, it shows your variables, and log outputs.

When you run and debug a project by throwing in breakpoints, you’ll see that your debugging console only has log outputs like so. There are no variables…you only see your output console.

In order to have the variables showing, go to:

xCode >> Preferences

and you should see and select Behaviors. Then you will see panels for Build, Testing, Running….

Under Running, select Start and on the right hand side select Variables and Console for debugger showings.

Do the same for ‘Pauses’ and ‘Generate Output’.

The ‘Variables & Console’ option tells the debugger to show the list of local variables as well as the console output each time a debugger session starts. If you wanted to view just the console output, you would select ‘Console View’. Likewise, if you wanted to see just the variables, you would select the ‘Variable View’.

The ‘Current Views’ option defaults to the last debugger view on your last debugger session. For example, if you closed Variables and opted to just the view the console, then just the console would open next time the debugger was started.

Now, you will see the variables appear when you debug