# WiseSVN For Unity Simple but powerful SVN Integration for Unity 3D utilizing [TortoiseSVN](https://tortoisesvn.net/) (for Windows), [SnailSVN](https://langui.net/snailsvn) (for MacOS) or [RabbitVCS](http://rabbitvcs.org/) (for Linux) user interface. A must have plugin if you use SVN as your version control system in your project. [Assets Store](https://assetstore.unity.com/packages/tools/version-control/wise-svn-162636) | [Unity Forum](https://forum.unity.com/threads/wise-svn-powerful-tortoisesvn-snailsvn-integration.844168/) | [Reddit](https://www.reddit.com/r/Unity3D/comments/fgjovk/finally_a_fully_working_tortoisesvn_snailsvn/) [![openupm](https://camo.githubusercontent.com/cb2049506a39f502fe3c28b61df5cee514a4ec5bd5e3799e17e3d0f69d83005d/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f6465766c6f636b65722e76657273696f6e636f6e74726f6c2e7769736573766e3f6c6162656c3d6f70656e75706d2672656769737472795f7572693d68747470733a2f2f7061636b6167652e6f70656e75706d2e636f6d)](https://openupm.com/packages/devlocker.versioncontrol.wisesvn/) ## Table of Contents [Features](https://github.com/NibbleByte/UnityWiseSVN/raw/master/#features)
[Usage](https://github.com/NibbleByte/UnityWiseSVN/raw/master/#usage)
[Installation](https://github.com/NibbleByte/UnityWiseSVN/raw/master/#installation)
[Overlay Icons](https://github.com/NibbleByte/UnityWiseSVN/raw/master/#overlay-icons)
[Screenshots](https://github.com/NibbleByte/UnityWiseSVN/raw/master/#screenshots)
## Features * **Hooks up to Unity move and delete file operations and executes respective svn commands to stay in sync.** * **Handles meta files as well.** * Moving assets to unversioned folder will ask the user to add that folder to SVN as well. * Moving folders / files that have conflicts will be rejected. * Will work with other custom tools as long as they move / rename assets using Unity API. * Provides assets context menu for manual SVN operations like commit, update, revert etc. * **Show overlay svn status icons** * Show server changes that you need to update. * Show locked files by you and your colleges. * Show "svn:ignore" and "svn:global-ignores" icons. * Displays warning in the SceneView when the current scene or edited prefab is out of date or locked. * Lock prompt on modifying assets by path and type (perforce checkout like) * If asset or its meta becomes modified a pop-up window will prompt the user to lock or ignore it. * The window shows if modified assets are locked by others or out of date, which prevents locking them. * If left unlocked, the window won't prompt again for those assets. Will prompt on editor restart. * Branch Selector * Scans for Unity projects in your SVN repository's branches. * Lists all available branches. * Opens Repo-Browser showing target asset in selected branch. * Opens "Show Log" on target asset in selected branch. * Switches to selected branch. * Scans for conflicts (shows which branches have changes to the target asset). * Minimal performance impact * Survives assembly reloads * You don't have to leave Unity to do SVN chores. * Works on Windows, MacOS and Linux. * Simple API to integrate with your tools. * Use `WiseSVNIntegration.RequestSilence()` and `WiseSVNIntegration.ClearSilence()` to temporarily suppress any WiseSVN pop-ups. * Use `WiseSVNIntegration.RequestTemporaryDisable()` and `WiseSVNIntegration.ClearTemporaryDisable()` to temporarily disable any WiseSVN handling of file operations and updates. * Use `SVNContextMenusManager` methods to invoke TortoiseSVN / SnailSVN / RabbitVCS commands. * Use `WiseSVNIntegration.*Async()` methods to run direct SVN commands without any GUI (check `ExampleStatusWindow`). *Check the screenshots below* ## Usage Do your file operations in Unity and the plugin will handle the rest. User SVN operations are available in the menu (or right-click on any asset): `Assets/SVN/...` **WARNING: Never focus Unity while the project is updating in the background. Newly added asset guids may get corrupted in which case the Library folder needs to be deleted.
Preferred workflow is to always work inside Unity - use the \"Assets/SVN/...\" menus. \"Assets/SVN/Update All\" will block Unity while updating, to avoid Unity processing assets at the same time.
This is an issue with how Unity works, not the plugin iteself. Unity says its by "design".** ## Installation * Asset Store plugin: https://assetstore.unity.com/packages/tools/version-control/wise-svn-162636 * [OpenUPM](https://openupm.com/packages/devlocker.versioncontrol.wisesvn) support: ``` npm install -g openupm-cli openupm add devlocker.versioncontrol.wisesvn ``` ... or merge this to your `Packages/manifest.json` (replace the package version **XXXXX** with current): ``` { "scopedRegistries": [ { "name": "package.openupm.com", "url": "https://package.openupm.com", "scopes": [ "devlocker.versioncontrol.wisesvn" ] } ], "dependencies": { "devlocker.versioncontrol.wisesvn": "1.4.XXXXX" } } ``` * Github upm package (**DO NOT RECOMMEND** as you need git installed) - merge this to your `Packages/manifest.json` ``` { "dependencies": { "devlocker.versioncontrol.wisesvn": "https://github.com/NibbleByte/UnityWiseSVN.git#upm" } ``` #### Prerequisites * You need to have SVN command line interface (CLI) installed. * **TortoiseSVN (for Windows)** comes with CLI, but needs to be added on installing ![SVN CLI](https://camo.githubusercontent.com/5b5cc952b6cf44cca07034a30d099c7f94872fb06d224faef6afa8ab9fc6d3bb/68747470733a2f2f692e737461636b2e696d6775722e636f6d2f5a717576482e706e67) * **For MacOS or Linux**, select one of the options here: https://subversion.apache.org/packages.html * You need to have [TortoiseSVN](https://tortoisesvn.net/) (for Windows), [SnailSVN](https://langui.net/snailsvn) (for MacOS) or [RabbitVCS](http://rabbitvcs.org) (for Linux) installed. ## Overlay Icons * Unversioned

* Modified

* Added

* Deleted

* Conflict

* Locked by me

* Locked by others

* Server has changes, update

## Screenshots ![OverlayIcons1](https://github.com/NibbleByte/UnityWiseSVN/raw/master/Docs/Screenshots/WiseSVN-OverlayIcons-Shot.png) ![OverlayIcons2](https://github.com/NibbleByte/UnityWiseSVN/raw/master/Docs/Screenshots/WiseSVN-OverlayIcons2-Shot.png) ![ContextMenu](https://github.com/NibbleByte/UnityWiseSVN/raw/master/Docs/Screenshots/WiseSVN-ContextMenu-Shot.png) ![File Operations](https://github.com/NibbleByte/UnityWiseSVN/raw/master/Docs/Screenshots/WiseSVN-Rename-Shot.png) ![Preferences](https://github.com/NibbleByte/UnityWiseSVN/raw/master/Docs/Screenshots/WiseSVN-Preferences-Shot.png) ![Lock Prompt](https://github.com/NibbleByte/UnityWiseSVN/raw/master/Docs/Screenshots/WiseSVN-Lock-Prompt.png) ![Locked Scene Warning](https://github.com/NibbleByte/UnityWiseSVN/raw/master/Docs/Screenshots/WiseSVN-Locked-Scene-Warning.png) ![Branch Selector](https://github.com/NibbleByte/UnityWiseSVN/raw/master/Docs/Screenshots/WiseSVN-BranchSelector.png)