ASK SDK Local Debug (Java)

About

ASK SDK Local Debug is a package which enables you to test your skill code locally against your skill invocations by routing requests to your developer machine. This enables you to verify changes quickly to skill code as you can test without needing to deploy skill code to Lambda.

NOTE: Feature is currently only available to customers in the NA region(https://developer.amazon.com/en-US/docs/alexa/custom-skills/develop-skills-in-multiple-languages.html#h2-multiple-endpoints).

Installation

Add the Maven package - ask-sdk-local-debug >= v1.0.0 as a test dependency to your skill package.

Configuration

USING with other IDEs and Debuggers

1. To instantiate a connection to the local debugging service, run the local debug application with com.amazon.ask.localdebug.LocalDebuggerInvoker as the start up program and the following arguments:

--accessToken <ACCESS_TOKEN>
--skillID <SKILL_ID>
--skillStreamHandlerClass <CLASS_NAME>
--region <REGION> # Optional argument. Region defaults to NA.

1. ACCESS_TOKEN:
    1. Install ASK CLI v2
    2. npm install ask-cli@2 -g
    3. Generate the accessToken using ASK CLI
    4. ask util generate-lwa-tokens --scopes alexa::ask:skills:debug
    5. You will be directed to a Login with Amazon page. Sign in and retrieve your ACCESS_TOKEN from the terminal.
2. SKILL_ID: The ID of the skill you are trying to debug. Ensure that the developer account you used to login to obtain the access token has access to this skill.
3. SKILL_STREAM_HANDLER_CLASS: The fully qualified name of the class in your skill package that implements either the SkillStreamHandler or SkillServlet class.
4. REGION: The region of the developer account. The accepted values are NA(North America), FE(Far East), EU(Europe). Defaults to NA. Instructions on finding out your region can be found [here](https://developer.amazon.com/en-US/docs/alexa/ask-toolkit/vs-code-testing-simulator.html#test).

2. Configure your preferred IDE or other debugging tool to attach to the above process or execute directly from your preferred IDE. For example, in VS Code, this would be included in the launch.json:

{
   "type": "java",
   "request": "launch",
   "name": "Skill Debug",
   "program": "<5. Program>",
   "args": [
        "--accessToken","<ACCESS_TOKEN>",
        "--skillId", "<SKILL_ID>",
        "--skillStreamHandlerClass", "<SKILL_STREAM_HANDLER_CLASS>",
        "--region", "<REGION>" # Optional argument. Region defaults to NA.
    ]
}

Things to note

1. Local debugging is only available for a skill’s development stage.
2. A connection remains active for **1 hour. **You will need to reinstantiate the connection after 1 hour.
3. All Alexa requests for the skill will be routed to your development machine while the connection is active.
4. Only one connection session may be active for a given skill ID and developer account.

Opening Issues

For bug reports, feature requests and questions, we would like to hear about it. Search the existing issues and try to make sure your problem doesn’t already exist before opening a new issue. It’s helpful if you include the version of the SDK, Node.js or browser environment and OS you’re using. Please include a stack trace and reduced repro case when appropriate, too.

License

This SDK is distributed under the Apache License, Version 2.0, see LICENSE for more information.