Skip to content

README.md

Latest commit

 

History

History
102 lines (76 loc) · 3.22 KB

README.md

File metadata and controls

102 lines (76 loc) · 3.22 KB

Unity Setup Guide for Project Installation

1. System Requirements

  • Operating System: Windows 10/11 or macOS 10.14+
  • Disk Space: Minimum 25GB free
  • Hardware: Graphics card supporting DX11/OpenGL 3.2+

2. Install Unity Hub (Version Manager)

  1. Download Unity Hub:

  2. Run Installer:

    • Execute the downloaded file (UnityHubSetup.exe or .dmg)
    • Follow the installation wizard (accept all defaults)
    • Launch Unity Hub after installation

3. Install Unity 2020.3.48f1 (Specific Version)

  1. Get Correct Version:

    • Access version archive: Unity Archive
    • Locate exact version 2020.3.48f1
    • Click the "Hub installation" button of that version

  2. Installation Setup:

    • In Unity Hub's installation window click "Install" (May take 30+ minutes)

4. Add Android Modules (Required)

  1. In Unity Hub:
    • Go to "Installs" tab
    • Click ⚙️ gear icon next to installed version
    • Select "Add Modules"

  1. Select Android Components: Check all:
    • Android Build Support
    • OpenJDK
    • Android SDK & NDK Tools

  1. Complete Installation:
    • Click "Install" (requires ~5GB additional space)
    • Wait for progress bar to complete

5. Open the Project

  1. In Unity Hub:
    • Go to "Projects" tab
    • Click "Open" → "Add project from disk"
    • Navigate to project /CollabAR/App folder (containing Assets and ProjectSettings)
    • Double-click to open (first launch takes 2-15 minutes)

6. Project Structure

  • 📁 Assets/ (All important content here)
    • ExtensionAssets/: ARCore setting files
    • Icons/ - Materials/: UI graphics
    • Prefabs/: Reusable GameObjects
    • Scenes/: UI screens (Linker.unity is the main scene)
    • Scripts/: C# code (edits via Visual Studio)
  • Packages/ (Do not modify - auto-managed dependencies)

7. Build for Android (Step-by-Step)

Requirements:

  • Android phone with:
    • Version 8.0 or newer
    • Developer mode enabled
    • USB debugging turned on

Process:

  1. Prepare Build:

    • In Unity: File → Build Settings
    • Select Android platform (click "Switch Platform" if needed)
    • Check all "Scenes In Build" were added (Linker, DeveloperLinker, StudyGroup)

  2. Connect Device:

    • USB connection with debugging approved
    • Verify that your Run Device is properly selected

  3. Build & Run:

    • Click Build And Run button
    • Name your .apk file (e.g., CollabAR_v1.apk)
    • Wait 5-30 minutes (first build is slower)
    • App will auto-install on your phone

Troubleshooting Common Issues

  • SDK Errors: Verify all Android modules installed
  • Project Won't Load: Restart Unity Hub, check project path
  • Build Fails: Confirm all scenes are in "Scenes In Build"