# Trying the starter app

The LINE Login starter app for iOS lets you quickly see how LINE Login works on an iOS app.

# Prerequisites

To build and run the starter app, you need:

# Trying the starter app with the predefined sample channel

  1. Clone the LINE SDK v5.0 for iOS Objective-C starter app repository (opens new window).

    $ git clone https://github.com/line/line-sdk-starter-ios-v2.git
    
  2. Run the following command from the LineSDKStarterObjC folder.

    $ pod install
    
  3. Open the LineSDKStarterObjC.xcworkspace file.

  4. Build the LineSDKStarterObjC project. The starter app launches in Simulator.

# Trying the starter app with your own channel

You can also link the starter app to your own channel. If you don't have a channel, you can create one in the LINE Developers Console. This also requires selecting or creating a provider.

After creating a channel, link the starter app to it by making these changes:

  • In the LINE Developers Console, configure your channel as described in Linking your app to your channel.
  • Change the app bundle ID to the ID configured in your channel.
  • In the info.plist file, change the ChannelID value to your channel ID.

# Running the starter app

Run the starter app using an iOS device or Simulator. When you first log in, you must agree to let the app access your profile information.

# Using the "Log in with LINE" button

Tap the "Login with LINE" button to log in using app-to-app login.

If LINE is installed on the device and you are logged in, you will be able to log in to the starter app automatically without entering your LINE credentials. Otherwise, you'll be requested to log in by using your device's browser. In this scenario, you'll need to enter your LINE credentials.

# Using the "Browser Login" button

Tap the "Browser Login" button to log in using a Safari web view. The LINE Login dialog opens in a web view where you can enter your LINE credentials (email and password) to log in.

# Try out the features available on the LINE SDK

Once you have logged in to the app, you can tap the menu items to try out these features of the LINE SDK.

  • Log out the user
  • Get the user profile
  • Verify the access token
  • Refresh the access token
  • Get the friendship status between a LINE Official Account linked to the channel and user
  • View ID token information