{"id":88,"date":"2020-06-20T20:23:51","date_gmt":"2020-06-20T18:23:51","guid":{"rendered":"https:\/\/www.baynado.de\/amazon\/?p=88"},"modified":"2022-10-31T08:13:16","modified_gmt":"2022-10-31T07:13:16","slug":"alexa-skill-kit-command-line-interface-ask-cli-version-1-zu-version-2-migration","status":"publish","type":"post","link":"https:\/\/www.baynado.de\/amazon\/skills\/alexa-skill-kit-command-line-interface-ask-cli-version-1-zu-version-2-migration","title":{"rendered":"Alexa Skill Kit Command Line Interface (ASK CLI ) Version 1 zu Version 2 Migration"},"content":{"rendered":"<p><img decoding=\"async\" class=\"size-full wp-image-25981 aligncenter lazyload\" data-src=\"https:\/\/www.baynado.de\/blog\/wp-content\/uploads\/amazon-alexa-logo.jpg\" alt=\"Amazon Alexa Logo\" width=\"720\" height=\"357\" src=\"data:image\/svg+xml;base64,PHN2ZyB3aWR0aD0iMSIgaGVpZ2h0PSIxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjwvc3ZnPg==\" style=\"--smush-placeholder-width: 720px; --smush-placeholder-aspect-ratio: 720\/357;\" \/><\/p>\n<p>Vor kurzem bin ich eine typische &#8222;Read the Fucking Manual Falle&#8220; hereingefallen. Als Alexa-Skill-Entwickler k\u00fcmmere ich mich regelm\u00e4\u00dfig um meine Skills und erweitere diese. F\u00fcr die Programmierung nutze ich MS Visual Studio Code als IDE. Meinen lokal geschrieben Code lade ich \u00fcber das ASK CLI direkt per Kommandozeile hoch. Das geht so am schnellsten und einfachsten. Bei meinem letzten Update habe ich noch schnell mal eben das <a href=\"https:\/\/www.npmjs.com\/package\/ask-cli\" target=\"_blank\" rel=\"noopener noreferrer\">Node.JS Package f\u00fcr das ASK CLI<\/a> schnell erneuert mit dem Befehl <code>npm i ask-cli<\/code>. Dumm war nur, dass ich nicht die Anleitung genau gelesen habe, sondern nur die neue Versionsnummer gesehen habe und darauf gehofft habe, dass ein einfaches Update keinen gr\u00f6\u00dferen\u00a0 Schaden verursacht.<\/p>\n<p>Nat\u00fcrlich kam es dann doch anders als erwartet. Ich sag nur, &#8222;<em>never change a running system!<\/em>&#8220; Seit dem 4. Mai 2020 gibt es die neue ASK CLI Version 2. Dies wurde gro\u00df im <a href=\"https:\/\/developer.amazon.com\/en-US\/blogs\/alexa\/alexa-skills-kit\/2020\/05\/efficiently-manages-kill-resources-automate-tasks-with-cLIv2-ga\" target=\"_blank\" rel=\"noopener noreferrer\">Amazon Alexa Blog<\/a> angek\u00fcndigt! Den Blogpost habe ich auch damals schon gelesen, nur was ein wenig bei mir unterging, war der Umstand, dass Amazon grundlegende Funktionen entweder entfernt hat oder mit ganz anderen Befehlen belegt hat.<\/p>\n<p>Das ganze bei\u00dft sich jetzt auch mit dem Kapitel 6.4 in meinem <a href=\"https:\/\/www.baynado.de\/blog\/amazon\/skills\/buchtipp-alexa-skills-programmieren\">Alexa Skills programmieren Buch<\/a>, was ja dieses Jahr im April erschienen ist. Daher f\u00fchle ich mich nun besonders verpflichtet, zumindest hier \u00fcber meinen Blog ein Update zu ver\u00f6ffentlichen. Grunds\u00e4tzlich hat sich nicht viel an dem ge\u00e4ndert, was ich damals in meinem Buch ver\u00f6ffentlicht habe.\u00a0 Die Anleitung zur Installation und die Hauptbefehle bleiben gleich.\u00a0 Es haben sich aber eben auch\u00a0 ein paar CLI Befehle ge\u00e4ndert, die wahrscheinlich einige Entwickler in den Wahnsinn treiben werden.<\/p>\n<h2>Was ist der Vorteil von ASK CLI V2 gegen\u00fcber ASK CLI V1?<\/h2>\n<p>Neben den Umstand, dass die alte Version nicht mehr weiterentwickelt wird, gibt es eben auch ein paar weitere Vorteile der zweiten Version gegen\u00fcber der ersten. So k\u00f6nnen nun auch Alexa Hosted Skills, das sind Skills, deren Programmcode direkt online in der Skill Console geschrieben wird, nun auch lokal entwickelt werden.\u00a0 Dann sollen bestimmte Entwicklungsabl\u00e4ufe leichter automatisierbar sein. F\u00fcr mich als einfacher Entwickler ist das weniger spannend, aber in den USA gibt es mittlerweile auch Tool-Anbieter mit denen man Skills in einer eigene grafischen Oberfl\u00e4che erstellen kann, diese Tool-Anbieter d\u00fcrften diese Neuerungen sehr spannend finden.<\/p>\n<h2>Was hat sich jetzt ge\u00e4ndert im ASK CLI?<\/h2>\n<p>Der alte Befehl<code>ask init<\/code>, mit dem man sich in sein Entwicklerkonto angemeldet hat wurde durch <code>ask configure<\/code> ersetzt. Hierbei ist mir die grundlegende \u00c4nderung von ASK CLI V2 zu V1 aufgefallen.\u00a0 In der neuen Version bedeutet <code>ask init<\/code>, dass man einen neuen oder ein bestehendes Alexa-F\u00e4higkeiten-Projekt einrichten m\u00f6chte. Der Befehl hilft dabei eine <strong>ask-resources.json-Datei<\/strong> zu erstellen, um die Bereitstellung des Skills zu unterst\u00fctzen. Er legt die gebr\u00e4uchlichsten Attribute fest und schl\u00e4gt sinnvolle Standardeinstellungen f\u00fcr die Verwendung von AWS-Lambda als Endpoint vor.<\/p>\n<p>Da sind wir auch schon bei der n\u00e4chsten H\u00fcrde. Wenn Du also schon einen bestehenden Alexa Skill per ASK CLI V2 hochladen m\u00f6chtest, musst Du diesen an die neue Verzeichnisstruktur anpassen, andernfalls\u00a0 wirst Du scheitern! Genau dieser Fall trat auch bei mir ein. Zum Gl\u00fcck war mein Englisch so gut, dass ich etwas mit der <a href=\"https:\/\/developer.amazon.com\/de-DE\/docs\/alexa\/smapi\/ask-cli-v1-to-v2-migration-guide.html\" target=\"_blank\" rel=\"noopener noreferrer\">Amazon Dokumentation<\/a> \u00fcber die Migration von ASK CLI V1 zu V2 anfangen konnte, aber nicht jeder Programmierer kann gut Englisch, oder schreckt zumindest davor zur\u00fcck.<\/p>\n<p><em><strong>Wenn Du also ein schon bestehenden Alexa Skill, der zuvor mit ASK\u00a0 CLI V1 hochgeladen wurde,\u00a0 jetzt mit ASK CLI V2 hochladen m\u00f6chtest, musst Du die Verzeichnisstruktur Deines Skills anpassen.<\/strong><\/em><\/p>\n<p>Zum Gl\u00fcck hat Amazon daran gedacht und daf\u00fcr einen extra ASK CLI V2 Befehl eingef\u00fchrt. Mit dem CLI Befehl <code>ask util upgrade-project<\/code> wird die alte Verzeichnisstruktur vom ASK CLI V1 an die neue Verzeichnisstruktur von ASK CLI V2 angepasst.<\/p>\n<h2>Alexa Skill Verzeichnisstruktur als und neu im \u00dcberblick<\/h2>\n[row]\n[column size=&#8217;1\/3&#8242;]\n<p><strong>Projekt Komponente<\/strong><\/p>\n<p>Projekt Konfiguration<\/p>\n<p>Skill package<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>Skill-code<\/p>\n<p>Skill Hosting Infrastruktur<\/p>\n[\/column]\n[column size=&#8217;1\/3&#8242;]\n<p><strong>v1.x<\/strong><\/p>\n<p><span style=\"color: #ff0000;\">.ask\/config<\/span><\/p>\n<p><span style=\"color: #ff0000;\">skill.json<\/span><\/p>\n<p><span style=\"color: #ff0000;\">models\/xx-YY.json<\/span><\/p>\n<p><span style=\"color: #ff0000;\">isps\/<\/span><\/p>\n<p>&#8230;<\/p>\n<p><span style=\"color: #ff0000;\">lambda\/<\/span><\/p>\n<p>N\/A<\/p>\n[\/column]\n[column size=&#8217;1\/3&#8242;]\n<p><strong>v2.x<\/strong><\/p>\n<p><span style=\"color: #ff0000;\">ask-resources.json<\/span><\/p>\n<p><span style=\"color: #ff0000;\">skill-package\/skill.json<\/span><\/p>\n<p><span style=\"color: #ff0000;\">skill-package\/interactionModels\/xx-YY.json<\/span><\/p>\n<p><span style=\"color: #ff0000;\">skill-package\/isps\/<\/span><\/p>\n<p>&#8230;<\/p>\n<p><span style=\"color: #ff0000;\">lambda\/<\/span><\/p>\n<p><span style=\"color: #ff0000;\">infrastructure\/<\/span><\/p>\n[\/column]\n[\/row]\n<p>Der Upgrade Befehl erstellt auch einen versteckten Ordner namens <span style=\"color: #ff0000;\">.\/legacy<\/span>, der eine Kopie des v1-Skillprojekts vor dem Upgrade enth\u00e4lt. Wenn das Upgrade nicht erfolgreich ist, kann man den Inhalt des Ordners .\/legacy nutzen, um den vorherigen Zustand des Skillprojekts wiederherzustellen.<\/p>\n<h2>Nutze stets die Windows Shell mit Administratorrechten<\/h2>\n<p>Das ist ein sehr wichtiger Hinweis, den je nachdem wie man sich in seine Windows-Shell oder Kommandozeilenprogramm eingeloggt hat, k\u00f6nnen die Berechtigungen zum Erstellen von neuen Verzeichnissen variieren. Ich empfehle Windows Nutzern die Upgrade-Prozedur f\u00fcr den Skill stets in der Windows Shell mit Administratorrechten (<strong>Windows-Taste + x -Taste<\/strong> und dann <strong>a-Taste<\/strong> dr\u00fccken) durchzuf\u00fchren.<\/p>\n<h2>Alexa Skill klonen wird ein wenig komplizierter<\/h2>\n<p>Ein weitere wichtiger Befehl f\u00fcr mich ist komplett verschwunden im ASK CLI V2. Der Befehl <code>ask clone<\/code> hat fr\u00fcher bestehende Skills aus der Alexa Developer Console und der AWS Lambda heruntergeladen auf die eigene Festplatte. Jetzt kommt man nur noch an seinen AWS\u00a0 Skill Code, wenn man diesen direkt auf der AWS Lamda Webseite als Zip-Datei exportiert.<\/p>\n<p>Wenn du also eine bestehenden Alexa Skill, der selbst gehostet ist herunterladen m\u00f6chtest, musst du also zun\u00e4chst das Skill Projekt mit ask init anlegen und dann den Code auf der AWS Lambda Webseite herunterladen und in dein neu erstelltes Projektverzeichnis kopieren.<\/p>\n<p>Generell alle\u00a0 Lambda Kommandos sind aus dem ASK CLI V2 verschwunden, was ich sehr schade finde. Denn oft muss man ja nur ein wenig am Code ver\u00e4ndern und nicht den kompletten Skill hochladen.<\/p>\n<h2>ask clone gibt es nicht mehr!<\/h2>\n<p>In der neuen Version muss man immer den Befehl <code>ask deploy<\/code> nutzen um den Skill. Code zu erneuern, auch wenn man\u00a0 nur einen kleinen Bug im Code beseitigt hat. Das ASK CLI V2 erstellt darauf eine Zip-Datei des Codes und l\u00e4dt alle ver\u00e4nderten Dateien komplett hoch. Zum Gl\u00fcck pr\u00fcft das neu ASK CLI, ob sich auch das Sprachmodell ver\u00e4ndert hat und ignoriert dieses, falls keinen \u00c4nderungen vorhanden sind.<\/p>\n<p>Nat\u00fcrlich sind das nicht alle Befehle, die Du mit der ASK CLI nutzen kannst. Ich habe hier nur die f\u00fcr mich wichtigsten \u00c4nderungen dokumentiert. F\u00fcr den kompletten \u00dcberblick zum ASK CLI empfehle ich Dir diesen Link: <a href=\"https:\/\/developer.amazon.com\/de-DE\/docs\/alexa\/smapi\/ask-cli-command-reference.html\" target=\"_blank\" rel=\"noopener noreferrer\">https:\/\/developer.amazon.com\/de-DE\/docs\/alexa\/smapi\/ask-cli-command-reference.html<\/a> (Englisch) Was Du auch noch beachten solltest, wenn Du Dir die Amazon Referenzseite zum ASK CLI anschaust. Es gibt es oben einen blauen Button, wo Du zwischen der Referenz der alten und neuen Version wechseln kannst. Das habe ich erst viel zu sp\u00e4t gemerkt.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-26723 lazyload\" data-src=\"https:\/\/www.baynado.de\/blog\/wp-content\/uploads\/ask-cli-referenz.jpg\" alt=\"ASK CLI Referenz wechseln\" width=\"538\" height=\"358\" src=\"data:image\/svg+xml;base64,PHN2ZyB3aWR0aD0iMSIgaGVpZ2h0PSIxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjwvc3ZnPg==\" style=\"--smush-placeholder-width: 538px; --smush-placeholder-aspect-ratio: 538\/358;\" \/><\/p>\n<h2>ask diff gibt es nicht mehr!<\/h2>\n<p>Mit dem Befehl <code>ask diff<\/code> konnte man herausfinden, welche Version die aktuelle war, die lokale oder die cloud version. Diese Pr\u00fcfung findet jetzt immer beim Upload mit <code>ask deploy<\/code> automatisch statt.<\/p>\n<h2>Fazit<\/h2>\n<p>Mit der alten Version konnte ich schneller debuggen, weil ich mal eben nur die AWS Lambda Funktion mit den Befehl\u00a0 <code>ask deploy -t lambda<\/code> erneuen konnte. Jetzt muss ich warten bis das ASK CLI meinen Code als Zip-Datei komprimiert hat und der gesamte Skill wird deployed. Das dauert deutlich l\u00e4nger als vorher.\u00a0 Ich war auch am Anfang total w\u00fctend, weil ich unachtsam das Update gemacht hatte ohne mir \u00fcber die Konsequenzen im Klaren zu sein. Wer aus Versehen ein update, wie ich gemacht hat und \u00fcberhaupt nicht mit der V2 weiter arbeiten m\u00f6chte, muss das ASK CLI V2 komplett deinstallieren mit dem Kommando <code>npm uninstall ask-cli<\/code> und dann die alte Version mit den Befehl <code>npm install ask-cli@1.7.23<\/code> installieren.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Vor kurzem bin ich eine typische &#8222;Read the Fucking Manual Falle&#8220; hereingefallen. Als Alexa-Skill-Entwickler k\u00fcmmere ich mich regelm\u00e4\u00dfig um meine Skills und erweitere diese. F\u00fcr die Programmierung nutze ich MS Visual Studio Code als IDE. Meinen lokal geschrieben Code lade ich \u00fcber das ASK CLI direkt per Kommandozeile hoch. Das geht so am schnellsten und [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":145,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[1],"tags":[17,16],"class_list":["post-88","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-skills","tag-entwicklung","tag-programmierung"],"_links":{"self":[{"href":"https:\/\/www.baynado.de\/amazon\/wp-json\/wp\/v2\/posts\/88","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.baynado.de\/amazon\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.baynado.de\/amazon\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.baynado.de\/amazon\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.baynado.de\/amazon\/wp-json\/wp\/v2\/comments?post=88"}],"version-history":[{"count":1,"href":"https:\/\/www.baynado.de\/amazon\/wp-json\/wp\/v2\/posts\/88\/revisions"}],"predecessor-version":[{"id":316,"href":"https:\/\/www.baynado.de\/amazon\/wp-json\/wp\/v2\/posts\/88\/revisions\/316"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.baynado.de\/amazon\/wp-json\/wp\/v2\/media\/145"}],"wp:attachment":[{"href":"https:\/\/www.baynado.de\/amazon\/wp-json\/wp\/v2\/media?parent=88"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.baynado.de\/amazon\/wp-json\/wp\/v2\/categories?post=88"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.baynado.de\/amazon\/wp-json\/wp\/v2\/tags?post=88"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}