feat: PE-983: Update dev-cookbook examples to create "brightsign-dumps" folder

examples/README.md

@@ -4,6 +4,8 @@ Welcome to the examples directory! This guide will help you get started with the
 
 ## Available Examples
 
+Note that some starter examples include the creation of a `brightsign-dumps` folder, which is used by the BrightSign OS to store crash information and is very useful to BrightSign Support when troubleshooting. The creation of this folder is an optional but recommended step to help with diagnosing application issues.
+
 ### HTML & Web Storage Examples
 
 #### HTML Starter Example

examples/html-starter-example/autorun.brs

@@ -1,4 +1,10 @@
 function main()
+	' Create directory to store crash-dumps (optional)
+	dir = CreateDirectory("SD:/brightsign-dumps")
+	if not dir then
+		print "Could not create directory"
+	end if
+
 	' This interface is the preferred way for JavaScript content to communicate with its parent application.
 	' https://brightsign.atlassian.net/wiki/x/-gAeG
 	mp = CreateObject("roMessagePort")

examples/node-simple-server-example/src/autorun.brs

@@ -1,4 +1,9 @@
 function main()
+    ' Create directory to store crash-dumps (optional)
+	dir = CreateDirectory("SD:/brightsign-dumps")
+	if not dir then
+		print "Could not create directory"
+	end if
 
     mp = createobject("roMessagePort")
 

examples/node-starter-example/autorun.brs

@@ -1,4 +1,9 @@
 function main()
+    ' Create directory to store crash-dumps (optional)
+	dir = CreateDirectory("SD:/brightsign-dumps")
+	if not dir then
+		print "Could not create directory"
+	end if
 
     mp = createobject("roMessagePort")
 

templates/cra-template-brightsign-app/template/src/autorun.brs

@@ -1,5 +1,11 @@
 function main()
 
+  ' Create directory to store crash-dumps (optional)
+	dir = CreateDirectory("SD:/brightsign-dumps")
+	if not dir then
+		print "Could not create directory"
+	end if
+
   mp = CreateObject("roMessagePort") 
 
   'Enable lDWS

templates/cra-template-brightsign-dashboard/template/src/autorun.brs

@@ -1,5 +1,11 @@
 function main()
 
+	' Create directory to store crash-dumps (optional)
+	dir = CreateDirectory("SD:/brightsign-dumps")
+	if not dir then
+		print "Could not create directory"
+	end if
+
 	' Create Message Port
 	mp = CreateObject("roMessagePort") 
     ' Enable lDWS

templates/html5-app-template/src/autorun.brs

@@ -1,5 +1,11 @@
 function main()
 
+	' Create directory to store crash-dumps (optional)
+	dir = CreateDirectory("SD:/brightsign-dumps")
+	if not dir then
+		print "Could not create directory"
+	end if
+
 	mp = CreateObject("roMessagePort") 
 	'Enable lDWS
 	EnableLDWS()