Swiftpack.co - Package - line/clova-cek-sdk-swift


About this repository

This is a library to help for development of the extension with the Clova Extension Kit (CEK). CEK Documentation can be found here.

This library also contains a sample project which returns local time of a city in the world about which an user asks Clova.


This library and the sample project can be built with the Swift Package Manager(SPM). It has a dependency on Kitura.

Following environment variables need to be set when it runs:

For the sample project

|Name|Value|Explanation|is Mandatory| | --- | --- | --- | --- | |PORT|Int|A port number to listen to|Yes (Heroku automatically sets it)| |APPLICATION_ID|String|An application Id that you set on the clova platform|Eiter this or PATH_FOR_DEBUG is necessary| |PATH_FOR_DEBUG|Any|If set, the server responds in <PATH_FOR_DEBUG> without verification|Eiter this or APPLICATION_ID is necessary| |LOG_TYPES|String|Log types to output. Combine following strings with ,: ENTRY, EXIT, DEBUG, VERBOSE, INFO, WARNING, ERROR|No| |GOOGLE_API_KEY|String|A user key for Google Geocoding API|No|

Preparation of development

To develop it with XCode, do

$ swift package generate-xcodeproj
$ open *.xcodeproj

Note that it requires macOS version >= 10.12 for some of Security framework methods

It has a Dockerfile which can be used by Docker. If you want to use Docker for build, execusion or deploy, install Docker. https://docs.docker.com/docker-for-mac/

Preparation in the Clova Platform for the sample app

This sample app handles an intent named CityTimeIntent, with a slot named city_name. Log into the platform and register them in your skill with enough number of corpora.

Build the sample app


$ swift build


$ docker-compose build web

Run the sample app

SPM(Hit Control+C to quit)

$ swift run

Docker(Hit Control+C to quit)

$ docker-compose up web

Deploy to Heroku with Docker

The webhook server for the extension requires SSL connection and we introduce Heroku as one of the solution.


Make sure Docker is running

$ docker ps

Install Heroku-CLI. Brew can be used:

$ brew install heroku/brew/heroku

Create your Heroku account. https://www.heroku.com

Log into Heroku and create your app. With heroku commands after here, you can specify existing app name by putting --apps .

heroku login
heroku create

Environment variables

Set necessary environment variables besides $PORT which is automatically set by Heroku.

$ heroku config:add LOG_TYPES="WARNING,ERROR"

Set PATH_FOR_DEBUG to answer any request without verification

$ heroku config:add PATH_FOR_DEBUG="/debug"


$ heroku container:login
$ heroku container:push web
$ heroku container:release web


How to run Vapor with Docker in Heroku https://gist.github.com/alexaubry/bea6f9b626e71b48ae6065664748bc97

Container Registry & Runtime (Docker Deploys) https://devcenter.heroku.com/articles/container-registry-and-runtime


Stars: 20

Used By

Total: 0


Separate dependency - 2018-10-10 02:26:06

The core part no longer rely on Kitura, so that an user who want to use Vapor or other web framework can only utilize it.

- 2018-07-12 06:46:57

Removed xcconfig.

Now swift package generate-xcodeproj, swift build and swift test do not need extra arguments.