XVim is a Vim plugin for Xcode. The plugin intends to offer a compelling Vim experience without the need to give up any Xcode features.
Xcode 8 Users, Follow instructions in INSTALL_Xcode8.md first.
Download source code or clone the repo. Then,
Confirm xcode-select
points to your Xcode
$ xcode-select -p
/Applications/Xcode.app/Contents/Developer
If this doesn't show your Xcode application path, use xcode-select -s
to set.
make
$ make
If you see something like
XVim hasn't confirmed the compatibility with your Xcode, Version X.X
Do you want to compile XVim with support Xcode Version X.X at your own risk?
Press y if you want to use XVim with your Xcode version (even it is not confirmed it works)
Create .xvimrc
as you need and restart your Xcode.
Launch Xcode. You'll be asked if you load XVim. Press 'Yes' to it. If you press 'No' by mistake, close the Xcode and execute the following from a terminal
defaults delete com.apple.dt.Xcode DVTPlugInManagerNonApplePlugIns-Xcode-X.X (X.X is your Xcode version)
Then relaunch Xcode.
XVim has several branches and releases. Usually you only need to download one of 'releases' and use it. Here is an explanation about each release and branch.
develop : New features and non critical bug fixes are merged into this branch. If you want experimental features use this branch.
Any other branches are temporary branches to develop features or bug fixes which will be merged into 'develop' branch after all. Any pull requests should be made to 'develop' branch.
$ make uninstall
Delete the following directory: $HOME/Library/Application\ Support/Developer/Shared/Xcode/Plug-ins/XVim.xcplugin
See separate FeatureList.md
Unfortunately XVim sometimes crashes Xcode. We are working on eliminating all the bugs, but it's really hard work. It helps greatly when we have your bug reports, with the following information:
XVim version ( Version number of the revision you built )
When it is hard to solve a problem with information above, take debug log according to the following movie please.
We appreciate if you write test case for the bug. Read "Write test" section in Documents/Developsers/PullRequest.md how to write test case. You do not need to update any source code but just write 7 items explained there in an issue you create.
XVim supports Bountysource. If you want to solve your issue sooner make bounty on your issue is one option. A contributer should work on it preferentially (not guaranteed though). To make bounty visit following link and go to "Issue" tab. Select your issue and make bounty on it.
https://www.bountysource.com/teams/xvim
See separate CONTRIBUTING.md
If you think the plugin is useful, please donate. There are two options you can take. Donate for Japan Earthquake and Tsunami Relief or back the project via BountySource. There is no rule that you cannot take both :) .
Since I do not intend make money from this project, I am directing donations to the people suffering from the damage of the 2011 Tohoku earthquake and tsunami in Japan.
Please donate directly through the Paypal donation site below, as this will put more money to good use by reducing the transfer fee.
https://www.paypal-donations.com/pp-charity/web.us/campaign.jsp?cid=-12
Since no messages are sent when you donate from the paypal link, you could also write a donation message on Message Board. I(we) would really appreciate it, and it will really motivate me(us)!
If you like to help and enhance the project directly consider backing this project via BountySource. You can back the team (which means you support the entire project) or you can make bounty on a specific issue. (If you have any bugs to be fixed or features to be implemented not in issues yet you can make one.)
See contributors page in github repository. https://github.com/XVimProject/XVim/contributors
MIT License