# Setting up your project

The LINE SDK for Unity provides an interface for using LINE SDK on either iOS or Android platform. To use LINE SDK in Unity Editor and export it to a platform, your development environment needs a few things.

# Unity requirements

  • Unity 2017.4 or later, with iOS and Android modules installed
  • A valid subscription for Unity Personal, Unity Plus, or Unity Pro

# Installation on iOS

To integrate LINE SDK for Unity on iOS, you need:

  • iOS 10.0 or higher as the deployment target
  • Xcode 10 or higher

On iOS, LINE SDK for Unity works as a wrapper for the LINE SDK for iOS Swift. You need a dependency manager to add the LINE SDK for iOS Swift to your project on iOS. You have two choices: CocoaPods or Carthage. Each choice has advantages and disadvantages:

Manager Advantages Disadvantages
CocoaPods (opens new window) Fast build speed, easy setup (only requires cocoapods gem). Requires you to create new, dedicated Xcode workspace.
Carthage (opens new window) You can use your usual project structure. Building with "Replace" enabled is slower. More prerequisites (carthage and local Ruby install).

CocoaPods is the default, recommended dependency manager used by LINE SDK for Unity. However, it requires a slightly different project structure than what you might be used to. Also, if your project is already using CocoaPods for another purpose, you may be forced to use Carthage. Choose the dependency manager that works best for you and your project.

# Ruby Environment

For either installation method, you need a valid local Ruby environment, to allow LINE SDK for Unity to install some gems needed for post-build processing. A Ruby version manager (like rbenv (opens new window) or rvm (opens new window)) and a recent version of Ruby installed should do. If you don't have a Ruby version manager, run the commands below:


The rbenv installation process varies depending on your environment. See https://github.com/rbenv/rbenv#installation (opens new window) for more accurate installation instructions.

$ brew install rbenv
$ rbenv init
$ echo 'eval "$(rbenv init -)"' >> ~/.zshrc
$ source ~/.zshrc

# Close your Terminal window and open a new one so your changes take effect.

# Install a Ruby version and make it the global version
$ rbenv install 2.5.0
$ rbenv global 2.5.0

# Now you should already have Ruby installed in a user path:
$ which ruby
=> /Users/your_user_name/.rbenv/shims/ruby

# Installing CocoaPods (default)

You need the pod command to be available on your machine for global Ruby. To install CocoaPods (opens new window), run:

$ gem install cocoapods

# Installing Carthage (alternative)

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. You can install Carthage with Homebrew (opens new window).

$ brew install carthage

# Installation on Android

You must have the Android SDK installed, because Unity will use it to build your project to the Android platform. If you have previously configured Unity for Android development (opens new window), you already have the Android SDK.