IOS - Revision history

Brion at 13:14, 20 June 2015

2015-06-20T13:14:45Z

← Older revision		Revision as of 13:14, 20 June 2015
Line 9:		Line 9:
	== CocoaPods ==		== CocoaPods ==

	[https://cocoapods.org/ CocoaPods] is a source-centric package manager for iOS and Mac OS X projects. libogg, libvorbis, and libtheora packages are in progress.		[https://cocoapods.org/ CocoaPods] is a source-centric package manager for iOS and Mac OS X projects built with Xcode. libogg, libvorbis, and libtheora packages [https://github.com/brion/OGVKit-Specs are in progress].

	See [[#OGVKit]] for a player widget wrapping these packages.		See [[#OGVKit]] for a player widget wrapping these packages.

Brion at 13:13, 20 June 2015

2015-06-20T13:13:39Z

← Older revision		Revision as of 13:13, 20 June 2015
Line 5:		Line 5:
	Cross-compile on OS X with Xcode command-line tools and the iOS SDK. You may have to install autoconf, automake, and libtool from Homebrew or manually.		Cross-compile on OS X with Xcode command-line tools and the iOS SDK. You may have to install autoconf, automake, and libtool from Homebrew or manually.

	The cross-compiled autotools builds only generate one architecture at a time, so you may wish to combine the output libraries into 'universal' form using lipo. (The frameworks listed below do this for you in their build systems~~; see [[#OgvKit]] for a relatively lightweight example~~.)		The cross-compiled autotools builds only generate one architecture at a time, so you may wish to combine the output libraries into 'universal' form using lipo. (The frameworks listed below do this for you in their build systems or leave linking to Xcode.)

	== CocoaPods ==		== CocoaPods ==

Brion: CocoaPods packaging in progress, OGVKit updates, couple brief notes on VLC for iOS usage

2015-06-20T13:11:41Z

CocoaPods packaging in progress, OGVKit updates, couple brief notes on VLC for iOS usage

← Older revision		Revision as of 13:11, 20 June 2015
Line 1:		Line 1:
	At least libogg, libvorbis, and libtheora build for and run on iOS without modification in their current incarnations.		At least libogg, libvorbis, and libtheora build for and run on iOS without modification in their current incarnations.

	== ~~Basic building~~ ==		== Cross-compiling ==

	Cross-compile on OS X with Xcode command-line tools and the iOS SDK. You may have to install autoconf, automake, and libtool from Homebrew or manually.		Cross-compile on OS X with Xcode command-line tools and the iOS SDK. You may have to install autoconf, automake, and libtool from Homebrew or manually.

	The cross-compiled autotools builds only generate one architecture at a time, so you may wish to combine the output libraries into 'universal' form using lipo. (The frameworks listed below do this for you in their build systems; see [[#OgvKit]] for a relatively lightweight example.)		The cross-compiled autotools builds only generate one architecture at a time, so you may wish to combine the output libraries into 'universal' form using lipo. (The frameworks listed below do this for you in their build systems; see [[#OgvKit]] for a relatively lightweight example.)

			== CocoaPods ==

			[https://cocoapods.org/ CocoaPods] is a source-centric package manager for iOS and Mac OS X projects. libogg, libvorbis, and libtheora packages are in progress.

			See [[#OGVKit]] for a player widget wrapping these packages.

			To use the low-level libraries directly in a CocoaPods app, add them to your Podfile:

			<pre>
			source 'https://github.com/CocoaPods/Specs.git'
			source 'https://github.com/brion/OGVKit-Specs.git' # temporary package home

			target 'MyProject'
			pod 'libtheora'
			pod 'libvorbis'
			# note 'libogg' will be automatically pulled in as a dependency
			end
			</pre>

			and re-run <code>pod install</code>.

			Todo:
			* use subspecs to enable/disable encoders
			* enable assembly acceleration for Theora
			* package libopus
			* upload the podspec to CocoaPods main repo
			* possibly upstream the podspec into the libraries

	== Frameworks ==		== Frameworks ==
Line 30:		Line 58:
	May add a few dozen megs to your app size.		May add a few dozen megs to your app size.

	=== ~~OgvKit~~ ===		=== OGVKit ===

	~~Experimental work~~ in progress ~~script~~ to build the libraries and wrap them with a high-level Objective-C interface that can be easily dropped into in an Xcode project: https://github.com/brion/~~OgvKit~~		Work in progress package to build the libraries and wrap them with a high-level Objective-C interface that can be easily dropped into in an Xcode project: https://github.com/brion/OGVKit

	~~Adds about 2MB~~ to ~~app size~~.		OGVKit is designed to be deployed as a [[#CocoaPods]] package, so it can be easily dropped into an Xcode project.

	~~==== Building ====~~		Currently supports basic Ogg Theora/Vorbis and WebM VP8/Vorbis playback; seeking is in progress and the API is being cleaned up.

	~~Build the C libraries first in a terminal~~:		<pre>
	* Requires autoconf, automake, and libtool; can be installed via homebrew.		source 'https://github.com/CocoaPods/Specs.git'
	* Run '~~make~~' ~~to build all C libraries~~		source 'https://github.com/brion/OGVKit-Specs.git' # temporary package home

	~~Once the C libs are built, you can fire up the OgvKit or OgvDemo projects in Xcode and run/test them directly:~~		target 'MyProject'
	* OgvKit: Xcode project with the Obj-C wrapper built as a static library		pod 'OGVKit'
	* OgvDemo: Xcode project with sample app, imports the OgvKit project		end
			</pre>

			and re-run <code>pod install</code>.

	~~==== Notes ====~~		The package can be trimmed down with subspecs, for instance to include only Ogg Vorbis playback (thus skipping other codecs):

	* CLI makefile builds each library for armv7, armv7s, arm64 for devices and i386, x86_64 for simulator, then combines them to multi-arch universal binaries		<pre>
	* wrapper library links to and encapsulates the low-level C libraries, so this should be usable in future Swift projects as well as Obj-C		pod 'OGVKit/Decoder/Ogg/Vorbis'
	* libtheora		</pre>
	** Must pass --disable-asm, as the asm code doesn'~~t build for iOS (yet?) [https:~~//~~gist.github.com~~/~~brion~~/~~7345164 errs]~~
	** doesn't build with iOS 7.1 SDK from the current git mirror -~~- need~~ to ~~get git mirror fixed or change build system to fetch from svn~~		Adds about 2-5MB to app size depending on options.

	=== Performance ===		=== Performance ===

	See preliminary benchmarks at https://github.com/brion/~~OgvKit~~/wiki/Device-notes		See preliminary benchmarks at https://github.com/brion/OGVKit/wiki/Device-notes and https://github.com/brion/OGVKit/wiki/Energy-usage

	== OS integration ==		== OS integration ==
Line 75:		Line 105:
	It is possible for an app that plays Ogg media to register its file types with the system, allowing other apps that may download files (Safari, Mail, Dropbox, etc) to prompt to open them in the player.		It is possible for an app that plays Ogg media to register its file types with the system, allowing other apps that may download files (Safari, Mail, Dropbox, etc) to prompt to open them in the player.

	~~I have implemented an early test of~~ this in ~~OgvKit demo player; it works but, for instance~~ Safari will download the entire file and '''then''' hand it off to the player, so you cannot play during the download.		VLC for iOS implements this but there are usability problems inherent in the system: Safari will download the entire file and '''then''' hand it off to the player, so you cannot play during the download.

	=== URL handler ===		=== URL handler ===
Line 83:		Line 113:
	It is possible for an app that plays Ogg media to register a URL handler, which would allow other apps or web content to launch the player. A remote URL could be included as a parameter on that URL, allowing apps or web content to hand off something to download-and-play progressively.		It is possible for an app that plays Ogg media to register a URL handler, which would allow other apps or web content to launch the player. A remote URL could be included as a parameter on that URL, allowing apps or web content to hand off something to download-and-play progressively.

	Unfortunately you can't do something like register for 'http[s]:///.ogv' -- you can only register a scheme such as 'x-ogvkit-player'. So you can't accept arbitrary HTTP or HTTPS links; the calling app or web content needs to know your app-specific URL scheme.		VLC for iOS implements this; prepend 'vlc:' to a URL to download or stream it in VLC.

			Unfortunately you can't do something like register for 'http[s]:///.ogv' -- you can only register a scheme such as 'vlc' or 'x-ogvkit-player'. So you can't accept arbitrary HTTP or HTTPS links; the calling app or web content needs to know your app-specific URL scheme.

	== Related projects ==		== Related projects ==

Brion: damn you autocorrect

2014-07-07T20:28:28Z

damn you autocorrect

← Older revision		Revision as of 20:28, 7 July 2014
Line 3:		Line 3:
	== Basic building ==		== Basic building ==

	Cross-compile on OS X with Xcode command-line tools and the iOS SDK. You may have to install autoconf, ~~automaker~~, and libtool from Homebrew or manually.		Cross-compile on OS X with Xcode command-line tools and the iOS SDK. You may have to install autoconf, automake, and libtool from Homebrew or manually.

	The cross-compiled ~~auto tools~~ only generate one architecture at a time, so you may wish to combine the output libraries into 'universal' form using lipo. (The frameworks listed below do this for you in their build systems; see [[#OgvKit]] for a relatively lightweight example.)		The cross-compiled autotools builds only generate one architecture at a time, so you may wish to combine the output libraries into 'universal' form using lipo. (The frameworks listed below do this for you in their build systems; see [[#OgvKit]] for a relatively lightweight example.)

	== Frameworks ==		== Frameworks ==

Brion: Rework page a little, add GStreamer information

2014-07-07T19:21:01Z

Rework page a little, add GStreamer information

@@ Line 1: / Line 1: @@
-At least libogg, libvorbis, and libtheora build and run on iOS without modification in their current incarnations.
+At least libogg, libvorbis, and libtheora build for and run on iOS without modification in their current incarnations.
-== Building ==
+== Basic building ==
 Experimental work in progress script to build the libraries and wrap them with a high-level Objective-C interface that can be easily dropped into in an Xcode project: https://github.com/brion/OgvKit
 Build the C libraries first in a terminal:
@@ Line 14: / Line 47: @@
-=== Notes ===
+==== Notes ====
 * CLI makefile builds each library for armv7, armv7s, arm64 for devices and i386, x86_64 for simulator, then combines them to multi-arch universal binaries
@@ Line 22: / Line 55: @@
 ** doesn't build with iOS 7.1 SDK from the current git mirror -- need to get git mirror fixed or change build system to fetch from svn
-== Performance ==
+=== Performance ===
 See preliminary benchmarks at https://github.com/brion/OgvKit/wiki/Device-notes
@@ Line 55: / Line 88: @@
 * [[ogv.js]] JavaScript codec works in iOS Safari
 {{DISPLAYTITLE:iOS}}

Brion: /* Building */ updates

2014-06-26T07:50:32Z

Building: updates

← Older revision		Revision as of 07:50, 26 June 2014
Line 3:		Line 3:
	== Building ==		== Building ==

	Experimental work in progress script to build the libraries ~~to .framework bundles~~ that can be easily ~~linked to~~ in an Xcode project: https://github.com/brion/OgvKit		Experimental work in progress script to build the libraries and wrap them with a high-level Objective-C interface that can be easily dropped into in an Xcode project: https://github.com/brion/OgvKit

			Build the C libraries first in a terminal:
			* Requires autoconf, automake, and libtool; can be installed via homebrew.
			* Run 'make' to build all C libraries

			Once the C libs are built, you can fire up the OgvKit or OgvDemo projects in Xcode and run/test them directly:
			* OgvKit: Xcode project with the Obj-C wrapper built as a static library
			* OgvDemo: Xcode project with sample app, imports the OgvKit project


	=== Notes ===		=== Notes ===

	* ~~uses existing autoconf build infrastructure; scripts wrap autogen.sh with appropriate settings, then combine the build products into framework bundles~~		* CLI makefile builds each library for armv7, armv7s, arm64 for devices and i386, x86_64 for simulator, then combines them to multi-arch universal binaries
	* framework bundles each ~~contain a 'fat binary'~~ library ~~with~~ armv7, armv7s, arm64 for devices and i386, x86_64 for simulator, ~~plus a subdirectory with~~ the C ~~headers~~		* wrapper library links to and encapsulates the low-level C libraries, so this should be usable in future Swift projects as well as Obj-C
	* libtheora		* libtheora
	** Must pass --disable-asm, as the asm code doesn't build for iOS (yet?) [https://gist.github.com/brion/7345164 errs]		** Must pass --disable-asm, as the asm code doesn't build for iOS (yet?) [https://gist.github.com/brion/7345164 errs]
			** doesn't build with iOS 7.1 SDK from the current git mirror -- need to get git mirror fixed or change build system to fetch from svn

	== Performance ==		== Performance ==

Brion: /* Related projects */ update link to ogv.js

2014-03-18T21:48:56Z

Related projects: update link to ogv.js

← Older revision		Revision as of 21:48, 18 March 2014
Line 44:		Line 44:
	== Related projects ==		== Related projects ==

	* [[~~JavaScript~~]] ~~codecs~~		* [[ogv.js]] JavaScript codec works in iOS Safari
	* [https://wiki.videolan.org/VLCKit/ MobileVLCKit] wraps many codecs including the main Xiph ones, and has a high-level player interface		* [https://wiki.videolan.org/VLCKit/ MobileVLCKit] wraps many codecs including the main Xiph ones, and has a high-level player interface

	{{DISPLAYTITLE:iOS}}		{{DISPLAYTITLE:iOS}}

Brion: /* Related projects */ MobileVLCKit

2014-02-09T21:39:10Z

Related projects: MobileVLCKit

← Older revision		Revision as of 21:39, 9 February 2014
Line 45:		Line 45:

	* [[JavaScript]] codecs		* [[JavaScript]] codecs
			* [https://wiki.videolan.org/VLCKit/ MobileVLCKit] wraps many codecs including the main Xiph ones, and has a high-level player interface

	{{DISPLAYTITLE:iOS}}		{{DISPLAYTITLE:iOS}}

Brion: /* Notes */

2013-11-09T13:09:45Z

Notes

← Older revision		Revision as of 13:09, 9 November 2013
Line 7:		Line 7:
	=== Notes ===		=== Notes ===

	* uses existing autoconf build infrastructure; scripts wrap autogen.sh with appropriate settings, then combine into framework bundles		* uses existing autoconf build infrastructure; scripts wrap autogen.sh with appropriate settings, then combine the build products into framework bundles
	* framework bundles each contain a 'fat binary' library with armv7, armv7s, arm64 for devices and i386, x86_64 for simulator, plus a subdirectory with the C headers		* framework bundles each contain a 'fat binary' library with armv7, armv7s, arm64 for devices and i386, x86_64 for simulator, plus a subdirectory with the C headers
	* libtheora		* libtheora

Brion at 13:09, 9 November 2013

2013-11-09T13:09:21Z

← Older revision		Revision as of 13:09, 9 November 2013
Line 4:		Line 4:

	Experimental work in progress script to build the libraries to .framework bundles that can be easily linked to in an Xcode project: https://github.com/brion/OgvKit		Experimental work in progress script to build the libraries to .framework bundles that can be easily linked to in an Xcode project: https://github.com/brion/OgvKit

			=== Notes ===

			* uses existing autoconf build infrastructure; scripts wrap autogen.sh with appropriate settings, then combine into framework bundles
			* framework bundles each contain a 'fat binary' library with armv7, armv7s, arm64 for devices and i386, x86_64 for simulator, plus a subdirectory with the C headers
			* libtheora
			** Must pass --disable-asm, as the asm code doesn't build for iOS (yet?) [https://gist.github.com/brion/7345164 errs]

	== Performance ==		== Performance ==

	See preliminary benchmarks at https://github.com/brion/OgvKit/wiki/Device-notes		See preliminary benchmarks at https://github.com/brion/OgvKit/wiki/Device-notes

	~~== Notes ==~~

	* libtheora
	** Must pass --disable-asm, as the asm code doesn't build for iOS (yet?) [https://gist.github.com/brion/7345164 errs]

	== OS integration ==		== OS integration ==