Difference between revisions of "IOSCompile"

From VideoLAN Wiki
Jump to navigation Jump to search
 
(7 intermediate revisions by the same user not shown)
Line 3: Line 3:
  
 
To develop VLC for iOS, you need:
 
To develop VLC for iOS, you need:
* Mac OS X Lion (or later)
+
* OS X 10.10 Yosemite (or later)
* Latest XCode version (4.6.3 works so far) - turn off version control in Xcode Preferences
+
* Latest Xcode version (version 6 works so far)
 
* A correct shell (we recommend iTerm2 and zsh)
 
* A correct shell (we recommend iTerm2 and zsh)
 
* [http://cocoapods.org CocoaPods] (for dependency management)
 
* [http://cocoapods.org CocoaPods] (for dependency management)
Line 10: Line 10:
 
== Get the source ==
 
== Get the source ==
  
If you want to develop VLC for iOS, it is '''highly recommended''' that you use the [[git]] version:
+
We provide source code packages for every release. You can find the latest on our [http://www.videolan.org/vlc/download-ios.html Download VLC for iOS website]. Older releases [http://download.videolan.org/videolan/vlc-iOS/ are also available].
 
 
git clone git://git.videolan.org/vlc-ports/ios.git
 
  
 
== Build it ==
 
== Build it ==
  
Build it for the simulator.
+
Install the dependencies
 
   
 
   
  sh compileVLCforiOS.sh -s
+
  pod update
  
 
Wait, and grab a coffee.
 
Wait, and grab a coffee.
  
 
+
Open the VLC.xcworkspace and run!
Manually assign the code sign in Xcode, and build it for devices.
 
 
 
sh compileVLCforiOS.sh
 
 
 
Grab a second coffee. :)
 
 
 
Better to have a look at the usage() function in compileVLCforiOS.sh, you might need -s to enable debug, -l or -n to save some time when you need to rebuild the project.
 
 
 
You might encounter lots of issues, just google it. Sometimes the issues might be about the project itself or the dependenies or the dependencies of the dependencies (:(the latest git and the dependencies might change at anytime), please report to the irc or trac, sometimes you might have to wait for a patch
 
  
 
== Deploy ==
 
== Deploy ==
Line 48: Line 37:
  
 
== Notes ==
 
== Notes ==
If everything goes well, congratulations to Lucky You! If not, please report any problem to our [http://mailman.videolan.org/listinfo/ios mailing list] ios@v.o, or on our [[IRC]].  
+
If everything goes well, congratulations to Lucky You! If not, please report any problem to our [http://mailman.videolan.org/listinfo/ios mailing list] ios@v.o, on our [[IRC]] or join us on the [http://forum.videolan.org forum].
 
 
This might help you more than Google, because everything might change at anytime.
 
  
 
=== History ===
 
=== History ===

Latest revision as of 15:38, 3 February 2018

Development environment

To develop VLC for iOS, you need:

  • OS X 10.10 Yosemite (or later)
  • Latest Xcode version (version 6 works so far)
  • A correct shell (we recommend iTerm2 and zsh)
  • CocoaPods (for dependency management)

Get the source

We provide source code packages for every release. You can find the latest on our Download VLC for iOS website. Older releases are also available.

Build it

Install the dependencies

pod update

Wait, and grab a coffee.

Open the VLC.xcworkspace and run!

Deploy

Open the .xcworkspace (not .xcodeproj) in Xcode and click on Run.

Buliding release version needs code signing

Before running simulator in Xcode, run .sh with -s first; Before running iphoneos in Xcode, run .sh without -s first.

Send patches

You can create patches and send them to our mailing list ios@v.o, or on our IRC.

Please see Git#Submitting_patches on how to send patches...

Notes

If everything goes well, congratulations to Lucky You! If not, please report any problem to our mailing list ios@v.o, on our IRC or join us on the forum.

History

The first version of this howto was written by jb on 18 July 2013.

Previous Version

The old version of the app can be compiled using this howto.