ShowTable of Contents
Getting started with development of iOS Apps for Lotus Notes / IBM XPages / IBM Domino applications.
Bug reports, Support, Questions, Answers, Suggestions
IMPORTANT!
Please DO NOT send bug reports, questions or suggestions by mail.
Please DO NOT send bug reports, questions or suggestions by mail.
Please DO NOT send bug reports, questions or suggestions by mail.
Bug Reports
If you have access to the YouAtNotes Issue Tracking system, use this for bug reports.
Questions and Suggestions
For everything that is not a bug, please post to http://support.youatnotes.com/dtg .
Hardware
You need a Mac for iOS development. Get yourself an iMac (recommended for stationary usage) or a Macbook.
Either way, choose a machine with the biggest display possible.
Software
- Download XCode from the Appstore (free).
- Download Titanium for Mac from Appcelerator (free, you only need to register).
- Download YouAtNotes Domino To Go Demo (not yet released, link follows) or buy the full Domino To Go package.
Setup
XCode
After downloading from the Appstore you find the XCode installer in the "Programs" section of the Finder, or in the Launchpad. Find it and let it install XCode.
When XCode is installed, you can copy the installer package to another Mac or delete it.
Titanium
- Open the DMG image and drag the Titanium folder to your programs.
- Open the folder and start Titanium.
- Titanium asks for a workspace folder. That is the folder where all the code will be stored.
- Go to File -> Preferences.
- If you don't like the dark theme, go to "Aptana Studio" -> "Themes" (in the preferences) and import the YouAtNotes theme found in the Domino To Go package.
- Go to "Aptana Studio" -> "Titanium" and make sure that the path to the iOS SDK Home is set. You don't need the Android SDK yet.
YouAtNotes Domino To Go
Basics
- Extract the Domino To Go Package somewhere.
- Open the dtg-repository.nsf in Notes and adjust the ACL to your needs. Create a copy to your development Domino server.
- Open the dtg-demo_contacts.nsf in Notes. If your development server is in a private network, you can leave the ACL as it is (default and anonymous have editor access). Otherwise edit the ACL as you want. Copy the database to your development Domino server.
- Make sure Domino runs the HTTP task.
Install and run the Contacts Demo
Copy the folder "YN DTG Demo - Contacts" to your Titanium workspace folder. In Titanium, choose File -> Import -> Existing Folder as New Project" and select "Titanium Mobile" in the next dialog page. Finish the importing process.
In the project in Titanium, edit "app.js" and change the App.baseURL variable (around line 30) so that points to the dtg-demo_contacts.nsf on your development server.
If you changed the ACL in the dtg-demo_contacts.nsf, set username and password in app.js (just below the App.URL variable).
Run the project in the iPhone or iPad simulator (you need to do this twice, the first time Titanium will dell you about the missing project and that it recreates the project, the second time Titanium actually compiles the code and starts the simulator).
About the Contacts Demo
Short tour:
- Click on "Navigation" to see the list of contacts (which is downloaded from the dtg-demo_contacts.nsf). The app downloads the data right after the start, so you should see the contact list in a moment.
- Click on the + button to create a new contact. Click on "Save" to save the contact data and upload it to Domino. Go back to the view, click the "reload" button to download the new contact and display it in the list.
- Click a contact to see a simple detail page.
- On the detail page, click on "Get full document" to download the full Domino document and display all items.
- On the detail page, click the "edit" button to change the contact's name or mail address. Click "save" to push the change to Domino, go back to the view, click "reload" to refresh the view in order to display the changed data.
See here for the full tour
Troubleshooting the Contacts Demo
App does not start in Simulator
The first start takes some time because Titanium needs to do a full rebuild. Watch the Titanium console. It should look something like this:
If Titanium complains about a wrong SDK version, edit the tiapp.xml file in the Titanium project. You might need to select another Titanium SDK version (1.8.0.1 or higher).
Simulator starts, but terminates after a moment
If your Mac is busy with other processes, the time the simulator need to start may be too long for Titanium. In this case you'll see a message "Application has exited from Simulator" in the Titanium console.
Quit some other programs on your Mac and try again.
Install YouAtNotes Domino To Go Framework
Copy the "YouAtNotes Framework" folder to your Titanium workspace folder and import it as a new project.
In new projects of your own, you can always copy & paste files from the YouAtNotes Framework project to your own project.
Install the YouAtNotes Framework Template for new projects
You can create new projects based on the YouAtNotes Framework template so that the complete YouAtNotes Framework is present in the new project automatically.
If you don't know how to import a project template into Titanium, follow these steps:
File -> New -> Ruby Project
Name: titanium.ruble, make sure that "I'll generate my own code, or use a project template" is selected. Click "Next".
Select the "Ruble template" and click "Finish".
Copy the YouAtNotes Template
Open the <workspace>/titanium.ruble/templates folder and copy the youatnotes_framework.zip file from the Domino To Go package to the folder.
Edit "templates/templates.rb" in the titanium.ruble project and paste this code:
project_template "YouAtNotes Domino To Go" do |t|
t.type = :titanium_mobile
t.location = "templates/youatnotes_framework.zip"
t.description = "YouAtNotes Domino To Go Framework"
t.replace_parameters = true
end
Done. If you use File -> New -> Titanium Mobile Project you can select the YouAtNotes Template and get the complete YouAtNotes Framework copied to your project automatically.
IMPORTANT NOTE
After you created a new project from the Domino To Go template and want to run it, sometimes the compile fails. If so, make a project -> clean, then it should run just fine.
|