Skip to content

Deployment Document

Jump to bottom
Ap13Crow edited this page Apr 13, 2025 · 9 revisions

Deployment Overview

  • Cross-Platform: The MiaLearningApp can run on Windows, macOS, or Linux.
  • .NET 8.0 Runtime: The target environment must have the .NET 8.0 runtime installed (unless you publish a self-contained package).
  • For additional usage details, see Use Instructions (or link to your separate wiki page).

Setup Instructions

  1. Download the Current Release
  • Obtain the ZIP file named MiaLearningApp.zip from your release page or distribution source.
  1. Copy File to Deployment Path
  • Copy (or move) the MiaLearningApp.zip to the desired location on the host device. For example, C:\MiaApp on Windows or ~/MiaApp on Linux/macOS.
  1. Unzip the File
  • Windows: Right-click → Extract All (or use a tool like 7-Zip).
  • macOS/Linux: Use built-in Archive Utility (GUI) or CLI tools (unzip MiaLearningApp.zip).
  • Ensure all extracted files are in the same folder.
  1. Confirm .NET Runtime
  • If you’re doing a framework-dependent deployment, check that .NET 8.0 is installed: dotnet --list-runtimes Look for .NETCoreApp 8.0 in the list.
  • If you provided a self-contained deployment, the runtime is included, so no extra install is required. Launch Instructions

Open a Terminal/Command Prompt Navigate to the directory where you extracted MiaLearningApp.dll and other files. For example: cd /path/to/MiaLearningApp Launch via CLI Run the app with: dotnet MiaLearningApp.dll On Windows, you can also double-click the .exe if you published an executable. On macOS/Linux, you might need to mark the file as executable (e.g., chmod +x MiaLearningApp if self-contained). Note: If a shortcut (MiaLearningApp.exe on Windows, or a shell script on Unix) is provided, ensure it’s located in the same directory with the other binaries. Launching from outside that directory might fail due to relative path issues. Follow Console Prompts The console app will open a main menu. Choose an option to begin using the MiaLearningApp features. Use Instructions

See the Use Instructions page for details on course management, adding notes, managing vocabulary, and taking quizzes in the console UI.

Additional Notes If you’re publishing a self-contained package, the user does not need to install .NET 8.0. Instead, your publish folder contains all runtime libraries. The usage instructions remain the same, except the command might be ./MiaLearningApp on Linux/macOS or MiaLearningApp.exe on Windows. If you plan to deploy updates often, consider versioning the ZIP files (e.g., MiaLearningApp_v1.2.zip) so users can track which release they have. Feel free to tailor the above text for your wiki layout, add screenshots, or reformat headings. This structure covers typical deployment steps for a console-based .NET application.

Clone this wiki locally