Community driven twister-core
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

94 lines
3.1 KiB

IOS (iPhoneOS) Build Instructions and Notes
===========================================
This guide will show you how to build twisterd for IOS on a linux machine.
Notes
-----
* Compilation, made on a linux
* Application, tested on iPhone4 with IOS 7.1.2 (jailbroken)
* All of the commands should be executed in a Terminal application.
Preparation
-----------
You need to install clang and llvm from distribution's repo. Then you need IOS toolchain and SDK.
You can get them from [iOS toolchain based on clang for linux](https://code.google.com/p/ios-toolchain-based-on-clang-for-linux/).
You need to install [openssl](http://cydia.saurik.com/package/openssl/) ([view in cydia...](cydia://package/openssl)) to your
device and copy headers and libraries to your SDK as well.
*REQUIRMENTS (leveldb, berkeley db and boost) WILL BE DOWNLOADED AND BUILDED BY `runme-ios-onlinux.sh` *
You need also to build [leveldb](http://github.com/google/leveldb), [Berkeley DB](http://download.oracle.com/otn/berkeley-db/db-5.3.28.tar.gz)
for IOS.
And you need the [boost sources](http://www.boost.org/users/download/#live).
Instructions:
-------------
#### Setting required variable
You should check variables set in `runme-ios-onlinux.sh` script.
export IOS_SDK=/usr/share/iPhoneOS6.0.sdk
export ARCH=armv7
export TARGET=arm-apple-darwin11
export LINKER_VER=236.3
export IPHONEOS_DEPLOYMENT_TARGET=6.0
export TARGET_OS=IOS
export CC="clang"
export CXX="clang++"
export PJC=2
#### Building dependecies and `twisterd`
1. Clone the github tree to get the source code and go into the directory.
git clone https://github.com/miguelfreitas/twister-core.git
cd twister-core/src
2. Building
./runme-ios-onlinux.sh
3. If things go south, before trying again, make sure you clean it up:
make clean
If all went well, you should now have a twisterd executable in the twister-core directory.
See the Running instructions below.
Running
-------
It's now available at `./twisterd`, provided that you are still in the `twister-core`
directory. We have to first create the RPC configuration file, though.
Run `./twisterd` to get the filename where it should be put, or just try these
commands:
mkdir -p "/User/.twister"
echo -e "rpcuser=user\nrpcpassword=pwd\nrpcallowip=127.0.0.1" > "/User/.twister/twister.conf"
chmod 600 "/User/.twister/twister.conf"
When next you run it, it will start downloading the blockchain, but it won't
output anything while it's doing this. This process may take several hours. If you see a lonely
`connect: Operation timed out`, don't freak out, it seems to work fine.
Other commands:
tail -f ~/.twister/debug.log
./twisterd --help # for a list of command-line options.
./twisterd -daemon # to start it as a daemon.
./twisterd help # When the daemon is running, to get a list of RPC commands
In order to get the HTML interface, you'll have to download it and link it in .twister:
git clone https://github.com/miguelfreitas/twister-html.git /User/Library/Application\ Support/twister/html
Once you do that, it will be available at http://localhost:28332/home.html