README.md 2.52 KB
Newer Older
1
# How to start development for VLC for iOS:
2

3
1. Run the compilescript with: ```sh compileVLCforiOS.sh```
4

5 6 7 8 9
    The first time around this will take roughly an hour and take up 7.5GB of free space.

2. Open `VLC for iOS.xcworkspace`.
3. Change `BUNDLE_IDENTIFIER_PREFIX` in `SharedConfig.xcconfig` to your domain name in reverse DNS style.
4. Hit "Build and Run".
10

Felix Paul Kühne's avatar
Felix Paul Kühne committed
11
If it compiled and ran in your simulator, throw confetti, celebrate or just cheers to that. 
12 13
You got further than a lot of people before you!

14
## Errors you might encounter on the way
15

16
### Ambiguous argument followed by some hash
17

Felix Paul Kühne's avatar
Felix Paul Kühne committed
18 19
If you look at the compilescript you see that VLCKit and Medialibrary are checked out by hash references. 
These are repositories within the VLC-iOS repo and if you encounter this error chances are you just need to go into the subfolders ImportedSources/MediaLibrarykit or ImportedSources/VLCKit and pull the latest commits
20 21 22
then go back and run the script again.
It just didn't know the hash because your repository was not up to date

23
### Connection timed out 
24

Felix Paul Kühne's avatar
Felix Paul Kühne committed
25
VLC has _many_ dependencies. It can happen that when you initially try to build vlc that some libraries are temporarily unavailable.
26 27 28 29 30 31
You have two options:
 
1. either you wait until the library is available again (often the server is just down) and start the script again
or 
2. you try to figure out which file couldn't be downloaded and try to find that resource somewhere else and put in the right place. Looking at the compile scripts helps here :)

32
### Build errors in Xcode
33

Felix Paul Kühne's avatar
Felix Paul Kühne committed
34 35
Are you sure you opened the workspace? 
We use cocoapods and it creates a workspace with all the integrated libraries. 
36 37
Chances are you opened the project file. 

Felix Paul Kühne's avatar
Felix Paul Kühne committed
38
If you have opened the workspace and still get errors you should check out the Notes section
39

40
## Submitting A Patch
41

Felix Paul Kühne's avatar
Felix Paul Kühne committed
42
So you added some code and are ready to contribute your commits but you don't see a way to make a pull request?
43 44
Soo *cough* we work with patches and Mailinglists like any good open source project! 

Felix Paul Kühne's avatar
Felix Paul Kühne committed
45
You should take a look at this: https://wiki.videolan.org/Sending_Patches_VLC/ but finally send the patch to ios@videolan.org.
46 47 48

Also, if you haven't yet, you might want to subscribe to this mailinglist: https://mailman.videolan.org/listinfo/ios

49
## Notes
50

Felix Paul Kühne's avatar
Felix Paul Kühne committed
51 52
For everything else, check: https://wiki.videolan.org/IOSCompile/
or look here: http://www.videolan.org/support/
53
For fast replies, IRC is probably the best way. We hang out in the #videolan channel on the freenode network. There is also a web interface: http://webchat.freenode.net/
54

55
We're happy to help!