Differences

This shows you the differences between two versions of the page.

--- 12114:demo [2024/04/15 03:54 UTC] – created mwolfe
+++ 12114:demo [2024/04/15 04:36 UTC] – [Customize the Addin Name and Description] mwolfe
@@ Line 1: / Line 1: @@
 ====== Demo Script: DevCon 2024 ======
-Create repo: ''M:\Repos\NLS\DevCon2024\.hg\''
+===== Download and Save Sample Code =====
-Open twinBASIC > **Sample 4**
+  - Download [[https://github.com/twinbasic/twinbasic/releases/tag/beta-x-0504|twinBASIC BETA 504]]
+  - Extract from Zip folder
+  - Open twinBASIC > **Sample 4**
+  - Enter Project Name: ''Demo2024'' (//Do not put spaces in the name//)
+  - Save as: ''%tmp%\Demo2024\Demo2024.twinproj''
+    - Navigate to: ''%tmp%''
+    - Create folder named: ''Demo2024''
+    - Filename: ''Demo2024.twinproj''
-{{:gb:fb:pasted:20240410-015035.png}}
+===== Customize the Addin Name and Description =====
+Next, let's customize the friendly name and description of our addin.  This is the info that appears in the VBA Add-in Manager dialog box.
-Save as: ''M:\Repos\NLS\DevCon2024\DevCon2024.twinproj'' (in repository folder)
+  - Go to **dllRegistration.twin** > **DllRegisterServer**
+  - In the "FriendlyName" line, replace //AddinProjectName// with ''"DevCon 2024 Demo"''
-Ignore ''*.twinproj'' files in repository:
+  - In the "Description" line, replace //AddinProjectName// with ''"Create a strongly-typed collection class from an existing VBA class object."''
-<file text .hgignore>
-syntax: glob
-*.twinproj
-</file>
-===== Set Export Path for Version Control =====
-  - Ensure a clean repository with initial commit of .hgignore
-  - **Project** > **Project Settings...**
-  - Search for "export"
-  - Check box next to "[√] Project: Export Path"
-  - Enter text: ''${SourcePath}\Source''
-    * //This will save the twinBASIC source files to a subfolder named "Source" in the same folder as the .twinproj file itself//
-  - Check box next to "[√] Project: Export After Save" and set value in dropdown to **Yes**
-  - Click [Save Changes]
-  - **File** > **Export Project...** to force an initial export
-  - In TortoiseHg, commit with the following message: ''initial export from twinBASIC IDE''
-    * The commit will include over 1,000 files; this is expected
-    * Most of the committed files come from referenced packages; that's ok
-    * [[nls>access-version-control-my-philosophy|Remember]], "Anything that can lead to a bug in our software belongs in version control."
-===== Test Build From Source in Empty Folder =====
-  - Create a new folder: ''%tmp%\DevConClone\''
-  - Clone the repository into this folder:  ''<nowiki>hg clone --verbose ssh://opal//home/gb/repos/devcon2024/ "C:\Users\Mike\AppData\Local\Temp\DevConClone"</nowiki>''
-  - Open a new instance of twinBASIC
-  - In the _| New |_ tab, click [Import from folder...] then [Open]
-  - Enter folder name: ''%tmp%\DevConClone\Source'' then [OK]
-  - **File** > **Save Project As...** > ''%tmp%\DevConClone\DevCon2024.twinproj'' > [Save]
-  - Make any small change to a project file
   - Save the project
-  - Commit the change and push to Opalstack
+  - Build the project
+  - Launch ''M:\Repos\NLS\DevCon2024\DevCon2024.accdb''
+  - Switch to VBA: <key>Ctrl</key> + <key>G</key>
-===== Test Build From Source for an Existing Project =====
+  - Dock the add-in window
+  - Go to "Add-Ins" > "Toggle myToolWindow Visibility"
-The twinBASIC IDE appears to currently lack a "Build from Source" method that will overwrite the current .twinproj file with the contents of the "Project: Export Path" setting.  As a result, we must use this multi-step workaround:
+  - Go to "Add-Ins" > "Add-in Manager"
+    * Point out the "DevCon 2024 Demo" item with description below
-  - In the original repository (''M:\Repos\NLS\DevCon2024''), pull changes from Opalstack
+  - Close "Add-In Manager" window
-  - Open a new twinBASIC instance OR go to **File** > **New Project...**
-  - In the _| New |_ tab, click [Import from folder...] then [Open]
-  - For folder, enter ''M:\Repos\NLS\DevCon2024\Source'' then click [OK]
-  - Go to **File** > **Save As...**
-  - Save project as ''M:\Repos\NLS\DevCon2024\DevCon2024.twinproj''
-  - Click [Yes] when asked to replace the existing file
-  - Confirm that the project successfully built from source:
-    - Go to **File** > **Export Project...** to force a full export of the source files
-    - Verify that new "Last Modified" dates have been created in ''M:\Repos\NLS\DevCon2024\Source\''
-    - Verify that there are no pending changes in the repository
 ===== Create the Tool Window Controls =====