Downgrade UI Files from XCode 8 to XCode 7

Wed, 07 Dec 2016 00:00:00 +0000

In one of my recent project I developed a module in XCode 8 as I had upgraded to it. Later I came to know that our team is currently working on XCode 7. So if we integrate XCode 8 UI files i.e .storyboard & .xib, the main project will not compile and will show following error.

1
2
3


The document "Main.storyboard" requires XCode 8.0 or later.

This version does not support documents saved in XCode 8 format. Open this document with XCode 8.0 or later.

1

The document "(null)" requires XCode 8.0 or later.

Although it is strongly recommended to upgrade your XCode as soon as some stable version arrives, there can come certain situations where you have to downgrade it. If you are a developer like me who is trying to downgrade his project to support XCode 7 here are two simple ways.

Using XCode 8:

If you have XCode 8 installed on your system, you can use this method to downgrade your storyboard files.

Open .storyboard/.xib file in XCode 8.0
On right side: Utility Area > File Inspecter > Interface Builder Document
Choose ‘XCode 7.x’ for ‘Opens in’s’ value. The process is shown in GIF below:

Using any text Editor

If you do not have access to XCode 8 at the moment you can use any of the text editors available to downgrade to XCode 7. So that you have no more build errors.

Just open your .storyboard/.xib file in a text editor of your choice and remove following line:

1

<capability name="Document saved in the Xcode 8 format" minToolVersion="8.0"/>

After removing this line you will be able to compile your project successfully.

To understand why we removed above line you can explore the changes once a UI file is saved in Xcode 8 format. If you will open .storyboard or .xib file on XCode 8 first time. It will show you a dialog as shown below to make these files compatible with XCode 8 document format.

OCLint integration in XCode with xctool

Mon, 28 Mar 2016 00:00:00 +0000

In a hurry to do things fast and meet monster deadlines, developers keep the book of best practices aside and start coding. The result can lead to unexpected behavior in your project along with highly unmanaged code. Start following best practices of coding, with time it will become a habit.

Even the experienced programmers sometimes can’t foresee the issues embedded in their code.

OCLint comes with a huge list of options which are way too lengthy anc can’t be covered in a single reading. In this tutorial we will cover best configurations suggested by OCLint documentation for XCode project.

About OCLint

OCLint is a static analyzer for C, C++ and objective c. The documentation to kick off your relationship with OCLint is huge and you will be jumping from one page to another in pursuit of something, something digestible. In this tutorial our goal is to Install, Integrate & View Analysis report of OCLint in XCode objective-c project.

Prerequisite

Homebrew
xctool
XCode
OSX

Installation

1. Homebrew, Easy and Recommended

If homebrew is configured on your system, you can use homebrew tap for oclint.

{% highlight text %} $ brew tap oclint/formulae $ brew install oclint {% endhighlight %}

And can be simplified to

{% highlight text %} $ brew install oclint/formulae/oclint {% endhighlight %}

Use following commands to update to latest version

{% highlight text %} $ brew update $ brew upgrade oclint {% endhighlight %}

2. Download

Ignore it if you have completed installation via Homebrew.

Go to OCLint Releases on github and download latest oclint-{versionno-architecture-OS}.zip/.tar.zip. Extract the files.

{% highlight text %} -oclint-x.y.z |–LICENSE |–bin (Contains OCLint commands, from here you can execute it) |–lib (Contains clang static analyzer, reporters and rules library) {% endhighlight %}

Set Path

Once installation is complete you can set path in terminal

{% highlight text %} OCLINT_HOME=/path/to/oclint-x.y.z export PATH=$OCLINT_HOME/bin:$PATH {% endhighlight %}

Verify Installation

Check whether installation is successful. If you see the output listed below, congratulations you did it.

{% highlight text %} $ oclint oclint: Not enough positional command line arguments specified! Must specify at least 1 positional arguments: See: oclint -help {% endhighlight %}

OCLint Commands

1. oclint

OCLint comes with rich set of options which you can use with ‘oclint’ command. In terminal type $ ocline --help to get detailed list of configurations.

2. oclint-json-compilation-database

It is great that OCLint provides us options to specify each file’s configurations. But in practical life our projects contains hundreds of files and it will give you a headache to do this manually. Here comes the solution oclint-json-compilation-database

Integration with XCode

Add the following script to new run script.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44


echo "Building ${TARGET_NAME}"
maxPriority=15000
#Add OCLint bin directory to PATH
export PATH=/usr/local/Cellar/oclint/0.10.2/bin:$PATH
#Set Build path
BUILD_PATH=${TARGET_TEMP_DIR}
#Check whether OCLint exists or not
hash oclint &> /dev/null
if [ $? -eq 1 ]; then
echo "OCLint not found, analyzing stopped"
exit 1
else
echo "OCLint is installed"
fi
#Navigate to build path directory
cd ${BUILD_PATH}

if [ ! -f compile_commands.json ]; then
echo "compile_commands.json not found, possibly clean was performed";
else
echo "Removing compile_commands.json"
rm compile_commands.json
fi
# clean previous output
if [ -f xcodebuild.log ]; then
echo "Removing xcodebuild.log"
rm xcodebuild.log
fi

cd ${SRCROOT}

#Clean, Build and generate compile_commands.json project
xctool -project DemoOCLintTargetInProject.xcodeproj \
-configuration Debug -scheme DemoOCLintTargetInProject \
-sdk iphonesimulator \
-reporter json-compilation-database:${BUILD_PATH}/compile_commands.json clean build

echo "Starting analyzing"
cd ${BUILD_PATH}
oclint-json-compilation-database -v -e Pods oclint_args \
"-max-priority-1=$maxPriority -max-priority-2=$maxPriority \
-max-priority-3=$maxPriority -rc LONG_LINE=500 \
-rc LONG_VARIABLE_NAME=100 -disable-rule=UnusedMethodParameter" \
| sed 's/\(.*\.\m\{1,2\}:[0-9]*:[0-9]*:\)/\1 warning:/'

Sample project

DemoOCLintTargetInProject is the project we used for above demo and is published on git.

Xcode on Nabeel's - iOS Developer Blog