# 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:
- Xcode installed
- Cocoapods (opens new window) installed
# Trying the starter app with the predefined sample channel
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
Run the following command from the
LineSDKStarterObjC
folder.$ pod install
Open the
LineSDKStarterObjC.xcworkspace
file.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 theChannelID
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