README.md #3

Xcode Perforce Plugin

Native Xcode Plugin that allows for Perforce integration

Features

  • Allows for p4 or p4vc commands to be executed on the currently selected file

Prerequisites

  • Xcode 6
  • p4 and p4vc command line apps be located in /usr/bin or any other path that is exported by Xcode (env)
  • ~/.bash_login file with the P4CONFIG setting set
  • Root of workspace client contains perforce.rc file with P4CLIENT variable set

An example .bash_login file would contain: export P4CONFIG=perforce.rc export P4PORT=myawesomedomain.com:1666 export P4USER=jaime_rios export P4PASSWD=PFourIzGr8

An example perforce.rc file, located at the root of your client, may contain P4CLIENT=jaime_rios_XcodePerforcePlugin

Install

  • Build the project, then restart Xcode

Usage

  • Select the "Source Control" menu -- Select any p4 or p4vc command you desire for the current active file

Uninstall

Run rm -r ~/Library/Application\ Support/Developer/Shared/Xcode/Plug-ins/XcodePerforcePlugin.xcplugin/

Known Issues

  • May be buggy, so use at your own risk
  • Only a limited set of p4 or p4vc commands were implemented
  • p4 edit only works on the currently selected file and does not checkout project files (at the moment)
# Xcode Perforce Plugin

Native Xcode Plugin that allows for Perforce integration

## Features

- Allows for p4 or p4vc commands to be executed on the currently selected file


## Prerequisites

- Xcode 6
- p4 and p4vc command line apps be located in /usr/bin or any other path that is exported by Xcode (env)
- ~/.bash_login file with the P4CONFIG setting set
- Root of workspace client contains perforce.rc file with P4CLIENT variable set


An example .bash_login file would contain:
export P4CONFIG=perforce.rc
export P4PORT=myawesomedomain.com:1666
export P4USER=jaime_rios
export P4PASSWD=PFourIzGr8


An example perforce.rc file, located at the root of your client, may contain
P4CLIENT=jaime_rios_XcodePerforcePlugin



## Install

- Build the project, then restart Xcode


## Usage

- Select the "Source Control" menu
-- Select any p4 or p4vc command you desire for the current active file

## Uninstall

Run `rm -r ~/Library/Application\ Support/Developer/Shared/Xcode/Plug-ins/XcodePerforcePlugin.xcplugin/`


## Known Issues

- May be buggy, so use at your own risk
- Only a limited set of p4 or p4vc commands were implemented
- p4 edit only works on the currently selected file and does not checkout project files (at the moment)
# Change User Description Committed
#9 16549 Jaime Rios Added debugging code to see paths exported by Xcode; modified MD readme file to include preferred location of p4 and p4vc binaries
#8 16417 Jaime Rios Added UUID for Xcode 7.1; Updated plugin icons to use newer Helix themed icons.
#7 13688 Jaime Rios Added Alcatraz in installation section of readme doc.
#6 12123 Jaime Rios Added compatibility for Xcode 6.2; modified the menu layout; added additional screenshot; updated URL for Alcatraz Package Manager.
#5 11740 Jaime Rios Updated readme text with additional known issues; refactored p4 revert function; added perforce icon to alert message.
#4 11737 Jaime Rios Minor change to error checking in debug mode; updated readme document with information pertaining to how to set up settings for workspace and edited MD markup formating.
#3 11736 Jaime Rios Added extra "known issue" in README.md document.
#2 11714 Jaime Rios Added unit tests; fixed bugs found during testing; added Jon Reid's XcodeCoverage files http://qualitycoding.org/xcode-code-coverage/ modified project to produce code coverage reports.
#1 11694 Jaime Rios Initial add of XcodePerforcePlugin project to guest depot.