{"_id":"5abba5c00117970012ba9b7a","category":{"_id":"5abba5c00117970012ba9b72","version":"5abba5c00117970012ba9b6e","project":"55093b151c38c50d00611894","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-03-18T09:01:41.604Z","from_sync":false,"order":4,"slug":"code-examples","title":"Code Examples"},"user":"55093bd84510200d00adf3c7","project":"55093b151c38c50d00611894","version":{"_id":"5abba5c00117970012ba9b6e","project":"55093b151c38c50d00611894","__v":2,"createdAt":"2018-03-28T14:25:04.622Z","releaseDate":"2018-03-28T14:25:04.622Z","categories":["5abba5c00117970012ba9b6f","5abba5c00117970012ba9b70","5abba5c00117970012ba9b71","5abba5c00117970012ba9b72","5ace17b040606a0003eabc75"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2.0"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-03-18T13:43:54.096Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":7,"body":"# Introduction #\n\nWelcome to _the first tutorial_ !\n\nThis example teaches you how to set up your Xcode project to link to the ISKN API.\n\nThe following tutorial assumes that the developer has already installed the latest version of Xcode.\nSo before you start, be sure you have your development environment set up.\n\n ## Setting up your project \n\nThis section teaches you how to set up your Xcode project to link to the ISKN API.\n\n### 1. Create a new project\n+ To create a new project which uses the __ISKN API__ ,open Xcode from the /Applications directory.\n The Xcode welcome window appears. \n \n Click __Create a new Xcode project__ \n (or choose __File__ > __New__ > __Project__ if a project window appears instead of the welcome window).\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/26d6265-Picture1.png\",\n        \"Picture1.png\",\n        1672,\n        1008,\n        \"#f3f3f3\"\n      ]\n    }\n  ]\n}\n[/block]\n Xcode opens a new window and displays a dialog box in which you choose a template:\n\n+ In the __iOS__ section at the left of the dialog box, select __Application__.\n+ In the main area of the dialog box, click __Single View Application__ and then click __Next__.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/572bf34-Picture2.png\",\n        \"Picture2.png\",\n        1464,\n        1058,\n        \"#edeeee\"\n      ]\n    }\n  ]\n}\n[/block]\n+ In the dialog box that appears, name your app MyFirstTest and choose additional options for your project then click __Next__ .\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/e7e2af9-Picture3.png\",\n        \"Picture3.png\",\n        1470,\n        1056,\n        \"#eaeae9\"\n      ]\n    }\n  ]\n}\n[/block]\n+ In the dialog box that appears, choose a location to save your project and click __Create__.\nXcode opens your new project in a window (called the workspace window):\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ee70e6e-Picture4.png\",\n        \"Picture4.png\",\n        2556,\n        1428,\n        \"#edeeee\"\n      ]\n    }\n  ]\n}\n[/block]\nYou might notice a warning message that says “No signing identity found.”\nThis warning means you haven’t set up Xcode for iOS development yet, but you can complete the tutorial without doing it.\n\n### 2.Link the DLL to the project \n\n+ In the project navigator, select the target MyFirstTest to which you want to add a library.\n\n+ Click Build Phases at the top of the project editor.\n\n+ Open the Link Binary With Libraries section.\n\n+ Click the Add button (+) to add the library.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/94cc34a-Picture5.png\",\n        \"Picture5.png\",\n        2560,\n        652,\n        \"#e8ebed\"\n      ]\n    }\n  ]\n}\n[/block]\nExternal libraries and frameworks are those not provided by the active SDK.\nThey don't appear in the list you see when you click the Add button (+),\nbut you can navigate to an external item by clicking the __Add Other...__ button below the list.\n\n+ Click __Add Other...__ and choose the __ISKN_API__ library.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/409e740-Picture6.png\",\n        \"Picture6.png\",\n        2504,\n        932,\n        \"#ebeced\"\n      ]\n    }\n  ]\n}\n[/block]\nYou should see the ISKN_API.a file nested under the Frameworks folder.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/e624614-Picture7.png\",\n        \"Picture7.png\",\n        2546,\n        740,\n        \"#e8eaec\"\n      ]\n    }\n  ]\n}\n[/block]\n### 3. Add a Header Search Path for the headers of the library\n\n+ In the project navigator, select the target MyFirstTest to which you want to add the Header Search Path.\n+ Click __Build Settings__ at the top of the project editor.\n+ Select __All__ in __Build Settings__ to show all the parameters, including \"Header Search Paths\".\n+ Select __Header Search Paths__ under __Search Paths__ and add the header directory.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7d0c873-Picture8.png\",\n        \"Picture8.png\",\n        2418,\n        1048,\n        \"#e7e9ea\"\n      ]\n    }\n  ]\n}\n[/block]\n ### 4.Add a Library Search Path for the headers of the library\n \nSelect __Library Search Paths__ under __Search Paths__ and add the library directory.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/d302ad1-Picture9.png\",\n        \"Picture9.png\",\n        2330,\n        1078,\n        \"#eaeaea\"\n      ]\n    }\n  ]\n}\n[/block]\n### 5.Test the project\n\n+ Now that everything is set up, go to your __storyboard__, drag a label object from the object library to your scene.\n+ Put 'Hello World !' as a text for the label. \n\nYou can now run the project. Your storyboard should look similar to this:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/HR35E84uQCylfEoGOMYA_Xcode_storyboard.png\",\n        \"Xcode_storyboard.png\",\n        \"606\",\n        \"636\",\n        \"#f28e46\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nYOU'RE NOW READY TO USE THE ISKN API!\n\n## Second section\n[Next example](magicbeep-example-on-ios)","excerpt":"","slug":"getting-started-with-iskn-api-on-ios","type":"basic","title":"Getting started with ISKN API on iOS"}

Getting started with ISKN API on iOS


# Introduction # Welcome to _the first tutorial_ ! This example teaches you how to set up your Xcode project to link to the ISKN API. The following tutorial assumes that the developer has already installed the latest version of Xcode. So before you start, be sure you have your development environment set up. ## Setting up your project This section teaches you how to set up your Xcode project to link to the ISKN API. ### 1. Create a new project + To create a new project which uses the __ISKN API__ ,open Xcode from the /Applications directory. The Xcode welcome window appears. Click __Create a new Xcode project__ (or choose __File__ > __New__ > __Project__ if a project window appears instead of the welcome window). [block:image] { "images": [ { "image": [ "https://files.readme.io/26d6265-Picture1.png", "Picture1.png", 1672, 1008, "#f3f3f3" ] } ] } [/block] Xcode opens a new window and displays a dialog box in which you choose a template: + In the __iOS__ section at the left of the dialog box, select __Application__. + In the main area of the dialog box, click __Single View Application__ and then click __Next__. [block:image] { "images": [ { "image": [ "https://files.readme.io/572bf34-Picture2.png", "Picture2.png", 1464, 1058, "#edeeee" ] } ] } [/block] + In the dialog box that appears, name your app MyFirstTest and choose additional options for your project then click __Next__ . [block:image] { "images": [ { "image": [ "https://files.readme.io/e7e2af9-Picture3.png", "Picture3.png", 1470, 1056, "#eaeae9" ] } ] } [/block] + In the dialog box that appears, choose a location to save your project and click __Create__. Xcode opens your new project in a window (called the workspace window): [block:image] { "images": [ { "image": [ "https://files.readme.io/ee70e6e-Picture4.png", "Picture4.png", 2556, 1428, "#edeeee" ] } ] } [/block] You might notice a warning message that says “No signing identity found.” This warning means you haven’t set up Xcode for iOS development yet, but you can complete the tutorial without doing it. ### 2.Link the DLL to the project + In the project navigator, select the target MyFirstTest to which you want to add a library. + Click Build Phases at the top of the project editor. + Open the Link Binary With Libraries section. + Click the Add button (+) to add the library. [block:image] { "images": [ { "image": [ "https://files.readme.io/94cc34a-Picture5.png", "Picture5.png", 2560, 652, "#e8ebed" ] } ] } [/block] External libraries and frameworks are those not provided by the active SDK. They don't appear in the list you see when you click the Add button (+), but you can navigate to an external item by clicking the __Add Other...__ button below the list. + Click __Add Other...__ and choose the __ISKN_API__ library. [block:image] { "images": [ { "image": [ "https://files.readme.io/409e740-Picture6.png", "Picture6.png", 2504, 932, "#ebeced" ] } ] } [/block] You should see the ISKN_API.a file nested under the Frameworks folder. [block:image] { "images": [ { "image": [ "https://files.readme.io/e624614-Picture7.png", "Picture7.png", 2546, 740, "#e8eaec" ] } ] } [/block] ### 3. Add a Header Search Path for the headers of the library + In the project navigator, select the target MyFirstTest to which you want to add the Header Search Path. + Click __Build Settings__ at the top of the project editor. + Select __All__ in __Build Settings__ to show all the parameters, including "Header Search Paths". + Select __Header Search Paths__ under __Search Paths__ and add the header directory. [block:image] { "images": [ { "image": [ "https://files.readme.io/7d0c873-Picture8.png", "Picture8.png", 2418, 1048, "#e7e9ea" ] } ] } [/block] ### 4.Add a Library Search Path for the headers of the library Select __Library Search Paths__ under __Search Paths__ and add the library directory. [block:image] { "images": [ { "image": [ "https://files.readme.io/d302ad1-Picture9.png", "Picture9.png", 2330, 1078, "#eaeaea" ] } ] } [/block] ### 5.Test the project + Now that everything is set up, go to your __storyboard__, drag a label object from the object library to your scene. + Put 'Hello World !' as a text for the label. You can now run the project. Your storyboard should look similar to this: [block:image] { "images": [ { "image": [ "https://files.readme.io/HR35E84uQCylfEoGOMYA_Xcode_storyboard.png", "Xcode_storyboard.png", "606", "636", "#f28e46", "" ] } ] } [/block] YOU'RE NOW READY TO USE THE ISKN API! ## Second section [Next example](magicbeep-example-on-ios)