{"componentChunkName":"component---src-templates-blog-post-js","path":"/how-to-integrate-vuukle-sdk-into-your-ios-app/","result":{"data":{"site":{"siteMetadata":{"title":"Vuukle Docs","author":"Vuukle"}},"markdownRemark":{"id":"0489decd-2c16-502c-9615-01a8b92e648f","html":"

​ [DEPRECATED]

\n

​ Support will be not provided

\n
\n

Additional video:

\n
\n

‘Vuukle’ iOS SDK framwork works with Objective-C and Swift 3.0 (or greater)

\n

• Home page Vuukle

\n

INSTALLATION

\n
\n

[0. Create Podfile for your Project] You can skip this step, if you already have Podfile

\n

Open terminal and change default directory to your project directory.

\n
-> Run command 'cd [your project path]' (EXAMPLE: 'cd /Users/fedir/Desktop/ExampleProject')
\n

Create Podfile.

\n
-> Run command 'pod init' and wait for completion
\n

Open Podfile in Xcode.

\n
-> Run command 'open -a Xcode podfile'
\n

[1. Add pod ‘Vuukle’ to list of pods]

\n

If you have just created new Podfile, add following lines of code to it (replace ‘ExampleProject’ with yor project name).

\n
platform :ios, '9.0'\n\ntarget '[your project name]' do\n\n  use_frameworks!\n  pod 'Vuukle'\n\nend
\n

If you already have Podfile simple add Vuukle to list of your pods.

\n
pod 'Vuukle'
\n

[!] For OBJECTIVE-C you should define version of Swift after target end.

\n
target '[your project name]' do\n   ...\nend\n\npost_install do |installer|\n  installer.pods_project.targets.each do |target|\n    target.build_configurations.each do |config|\n\n      config.build_settings['SWIFT_VERSION'] = '3.0'\n\n    end\n  end\nend
\n

[2. Install pods for Project]

\n

Close your project

\n
• EXAMPLE: If you have opened ExampleProject.xcodeproj, close it. After installation of pods you will work with ExampleProject.xcworkspace
\n

(If you closed terminal after step 0.) Open terminal again and change default directory to your project directory.

\n
-> Run command 'cd [your project path]' (EXAMPLE: cd /Users/fedir/Desktop/ExampleProject)
\n

Install pods for Project.

\n
-> Run command 'pod install' and wait for completion\n\nThis command will install latest version of pod 'Vuukle' and dependency pods:\n\n• 'Alamofire'      (version >= 4.3.0)\n• 'AlamofireImage' (version >= 3.2.0)\n• 'MBProgressHUD'  (version >= 1.0.0)\n• 'NSDate+TimeAgo' (version >= 1.0.6)
\n

[3. Please add to info.plist next parameter]

\n

Select info.plist in your project and add “App Transport Security Settings” and change type “String” to “Dictionary”. Then add to “App Transport Security Settings” - Allow Arbitrary Loads type “Boolean” value “YES”.http://stackoverflow.com/questions/31254725/transport-security-has-blocked-a-cleartext-http

\n

IMPORT SWIFT

\n
\n

[4. Add Vuukle to Embedded Binaries]

\n

Open generated after installation .xcworkspace file.

\n
• EXAMPLE: In project directory open ExampleProject.xcworkspace\n\nYou can also run using terminal:\n  -> Run command 'cd [your project path]' (EXAMPLE: cd /Users/fedir/Desktop/ExampleProject)\n  -> Run command 'open ExampleProject.xcworkspace'
\n

Open your project settings.

\n
Tap on your project in project navigator (in top left corner)
\n

Add Vuukle to Embedded Binaries

\n
• Select 'TARGETS' and scroll down to 'Embedded Binaries'\n• Tap on '+' button and select 'Add Other...'\n• Go to 'Pods -> Vuukle -> Vuukle' and select 'Vuukle.framework' file
\n

[5. Import Vuukle]

\n

Simple add ‘import Vuukle’ in the top of .swift file after other framworks your use.

\n
• EXAMPLE:\n\nimport UIKit\nimport Vuukle\n\nclass ExampleViewController: UIViewController {\n...
\n

IMPORT OBJECTIVE-C

\n
\n

[6. Open workspace and import Vuukle]

\n

Open generated after installation .xcworkspace file.

\n
EXAMPLE: In project directory open ExampleProject.xcworkspace\n\nYou can also run using terminal:\n-> Run command 'cd [your project path]' (EXAMPLE: cd /Users/fedir/Desktop/ExampleProject)\n-> Run command 'open ExampleProject.xcworkspace'
\n

Open your project settings.

\n

Tap on your project in project navigator (in top left corner)

\n

Add Vuukle to Embedded Binaries

\n

• Select ‘TARGETS’ and scroll down to ‘Embedded Binaries’ • Tap on ’+’ button and select ‘Add Other…’ • Go to ‘Pods -> Vuukle -> Vuukle’ and select ‘Vuukle.framework’ file

\n

[7. Import Vuukle]

\n

Simple add ‘#import <Vuukle/Vuukle-Swift.h>’ before @interface in .m file.

\n

• EXAMPLE:

\n

#import <Vuukle/Vuukle-Swift.h>

\n

@interface ViewController () … @end

\n

@implementation ViewController …

\n

USAGE SWIFT:

\n
\n

[8. Add vuukle comments to conent view for it]

\n

[!] You have add comments in this method of UIViewController:

\n

override func viewWillAppear(_ animated: Bool) { … }

\n

For nested comments (hold ‘Alt’ and click on method in Xcode to see more details):

\n

VUCommentsBuilder.addVuukleComments(baseVC: [Your view controller], baseScrollView: [Your main scroll view], contentView: [Your content view for vuukle], contentHeightConstraint: [Your content view height constraint], appName: [App name], appID: [App bundle ID], vuukleApiKey: [Vuukle api key], vuukleSecretKey: [Vuukle secret key], vuukleHost: [Vuukle host], vuukleTimeZone: [Your Time Zone], articleTitle: [Article title], articleID: [Article ID)], articleTag: [Article tag], articleURL: [Article URL])

\n

For own comments scroll (hold ‘Alt’ and click on method in Xcode to see more details):

\n

VUCommentsBuilder.addVuukleComments(baseVC: [Your view controller], contentView: [Your content view for vuukle], appName: [App name], appID: [App bundle ID], vuukleApiKey: [Vuukle api key], vuukleSecretKey: [Vuukle secret key], vuukleHost: [Vuukle host], vuukleTimeZone: [Your Time Zone], articleTitle: [Article title], articleID: [Article ID)], articleTag: [Article tag], articleURL: [Article URL], isScrollEnabled: true, edgeInserts: [Edge insrest for comments])

\n

[9. Update all heights]

\n

[!] You have update all hights in this method of UIViewController:

\n

override func viewDidAppear(_ animated: Bool) { … }

\n

To update height call method

\n

VUCommentsBuilder.updateAllHeights()

\n

If you app supports landscape orintation, you have to call this method after rotation.

\n

• EXAMPLE:

\n

override func didRotate(from fromInterfaceOrientation: UIInterfaceOrientation) { VUCommentsBuilder.updateAllHeights() }

\n

[10. LogIn through your application]

\n

VUCommentsBuilder.loginUser(name: [Your name], email: [Your email])

\n

VUCommentsBuilder.logOut()

\n

[11. Everything is ready, you can run the Project]

","frontmatter":{"title":"[DEPRECATED] How to integrate Vuukle SDK into your iOS app","date":"May 01, 2017","category":"Install Vuukle","tags":["how to","install","iOS","sdk"],"shortDescription":"We offer the powerful SDK ( software development kit) that allows to setup advanced commenting and user engagement system into any iOS application."}}},"pageContext":{"id":"0489decd-2c16-502c-9615-01a8b92e648f"}}}