LDSTechForumWikiProjects

LDS Tools for iPhone

LDS Tools Project Index edit

LDS Tools for iOS is a program to allow members to view their local unit and local stake information on their iPhones. Using the LDS Tools application, users can see local leadership, find individuals phone numbers and addresses, see stake and unit calendar events, and plot addresses on a map. This project is mostly contributed to by community developers.

Key project information

Version 2.0 is available now.

Support

The support email is ios-support@ldsmail.net

Known bugs

If you are having any problems, please go to LDS Tools for iPhone - Known Issues and make sure it is not a known bug before e-mailing the developer list.

Examine the list of fixes that have been fixed in 1.1.

Issue tracking (JIRA)

Feature and bug tracking is found in the LDSTech Jira tool. Although you can view issues in Jira, you cannot create or edit issues unless you have a JIRA account. To get your JIRA account, first make sure that you have completed all of the steps found in the Requirements for Participation wiki page. Your membership in the project should give you Jira access automatically.

Jira Project URL = https://tech.lds.org/jira/browse/MMIP

Source code

Access to the source code and issue tracking requires LDS Account authentication. If you do not have an LDS Account username/password, visit the ldsaccount.lds.org website.

First, you'll need to sign in to our code review tool with your LDS Account:

https://tech.lds.org/mobile/codereview

Skip the SSH key generation screen, and just scroll to the bottom and click on "Continue". Now send an email to Hal Rushton (h.rushton@ldschurch.org) and request access to the source code. Once you've been granted access, download the source code:

Setup the password caching. If you set this up before issuing the commands below, git will remember your credentials when you enter then in the commands below. Then git will not prompt you for your password later whenever you interact with the original repository. It must be setup before issuing the git clone command or your credentials will not be saved.

git clone https://tech.lds.org/mobile/codereview/p/LDSTools-iOS
username: <LDSAccount username>
password: <LDSAccount password>

Once that finishes you need to get the submodules.

cd LDSTools-iOS

git submodule update --init --recursive
username: <LDSAccount username>
password: <LDSAccount password>
You are prompted for a username/password for SQLCipher/openssl, and again for external/LDSCommon

Then go to https://tech.lds.org/wiki/Code_Review_for_iOS and make sure you've followed ALL of the instructions there.

Apple Developer membership

To develop any iPhone application, you must have a membership in the Apple Developers program. You can get developer information at the apple developer website.

Getting set up with TestFlight

We use TestFlight to distribute beta builds to the test team. Setup is quick and easy. Here's how to do it:

Visit https://testflightapp.com/ and create a new account.

Once your account is setup TestFlight will send you a confirmation email. Make sure you open it on your device and then click the "Login" link. This will register your devices to your account and allow you to download the TestFlight app.

Then contact Hal Rushton (h.rushton@ldschurch.org) and ask him to invite you to the LDS iOS Development Team. Once you get that invite (again, open it on your device) click the Accept link. This sends your device info to the group. Then we can release the app for your device.

Just watch the TestFlight app and it will tell you when a new release for your device is ready!

Build instructions

To build the iPhone version of the LDS Tools application, follow these steps. It is assumed that you have already downloaded and installed Apple's XCode development environment. These examples will assume that you are going to create a build to launch in the iPhone simulator in debug mode. I am also going to assume, that you have never gotten the source code for the project or Xcode working. For those that have part, you can modify this as needed.

  1. Be on Mac OS X Lion and Install Xcode 4.4 (Free Download from the Mac App Store)
  1. Launch Xcode, and open the "LDSTools.xcodeproj" inside the LDSToolsTrunk folder on the Desktop.
  2. We need to modify a few minor things to get everything working:
  3. XCode Menu -> Preferences
    1. Downloads (Install the Command Line Tools)
    2. Then, under "Locations" tap Source Trees
    3. Add a new Source Tree, and put in:
    4. Setting Name: "OPENSSL_SRC"
    5. Display Name: "OPENSSL_SRC"
    6. Path: "**FROM PWD CMD ABOVE**/SQLCipher/openssl" (example: "/Users/nate/Desktop/LDSToolsTrunk/SQLCipher/openssl")
  4. Close the preferences...
  5. To the right of the Stop Button, Select the Target "LDSTools Dev" and for the Sub-Menu, select iPhone 5.0 Simulator...
  6. Press the Run button, and sit back and wait. The first compile on my 2.4ghz iMac took about 2 minutes. Then the application launched in the simulator just perfect.


New LDS Tools iPhone Developers - A reference for those wanting to get started developing on LDS Tools

Screen shots

iOS Release Schedule

Version 1.1

  • Code updates cutoff: 5/24/2011
  • Regression test completion: 6/7/2011
  • Submit to App Store: 6/10/2011
  • Go live (approximate): 6/17/2011

Version 1.2

  • Code updates cutoff:6/21/2011
  • Regression test completion: 7/5/2011
  • Submit to App Store: 7/8/2011
  • Go live (approximate): 7/15/2011

Version 1.3

  • Code updates cutoff: 7/19/2011
  • Regression test completion: 8/2/2011
  • Submit to App Store: 8/5/2011
  • Go live (approximate): 8/12/2011

Version 1.4

  • Code updates cutoff: 8/16/2011
  • Regression test completion: 8/30/2011
  • Submit to App Store: 9/2/2011
  • Go live (approximate): 9/9/2011

Version 2.0

  • Code updates cutoff: TBD
  • Regression test completion: TBD
  • Submit to App Store: TBD
  • Go live (approximate): TBD

Version 2.1

  • Code updates cutoff: TBD
  • Regression test completion: TBD
  • Submit to App Store: TBD
  • Go live (approximate): TBD

iOS Requested/Planned Features

Version 1.1

  • Downloading code rewrite.
  • Forced re-download after 30 days.
  • Improved error reporting and error recovery.

Version 1.2

  • Calendar cleanup - partial
    • Add pull-to-refresh label (MMIP-349) (Done in 1.1)
    • Add church-wide events (this will be done at the directory level) (MMIP-354) (Closed in 1.1 - will not fix, as it's not an LDS Tools problem)
    • View calendar name for each item on iPad (MMIP-197) (Done in 1.1)

Version 1.3

  • Version deleted, content moved to 2.1

Version 1.4

  • Version deleted, content moved to 2.2

Version 2.0

  • Leadership reports
    • Implement UI changes for the Leadership section (MMIP-275)
    • Birthday list
    • New move-ins
    • Adults not endowed
    • Action & interview list summary(?)
    • Action & interview list
  • Calendar cleanup - uploads
    • Import calendar items to local calendar (MMIP-64)
    • Add new events; upload to server (MMIP-362, -363)
    • Add month & week views (MMIP-371, -372)
  • User updates
    • Allow user to update personal information (MMIP-364)

Version 2.1

  • Additional Leadership Reports
    • Leader Action Report(?)
    • Membership record summary
      • Includes temple recommend expiration date, membership number, spouse membership status, baptism & confirmation dates, endowed date, mission info, sealed to spouse, sealed to prior spouse, when set apart for current calling
    • Membership record details
      • Includes parents, etc.
  • Photo cleanup
    • Wide photos are cut off in photo view (MMIP-273, -360, -361)
    • Fix flaky photo behavior
    • Upload photos to server (MMIP-358)
    • Display both family and individual photos (MMIP-285)
  • Map cleanup
    • Allow modifying GPS coordinates for individual members (MMIP-366)
  • Callings cleanup
    • Add additional detail (MMIP-454)
  • Smart lists
    • Add smart lists (MMIP-97)

Version 2.2

  • Dialing cleanup
    • Strip non-numeric characters
    • Allow non-numeric characters, such as -()
    • Reformat phone number after editing (MMIP-100)
    • Add default area code (MMIP-231)
  • Text/email cleanup
    • General cleanup (MMIP-390)
    • Email calendar event details (MMIP-450)
  • Localization
    • Localize all strings (MMIP-347, -91)

Unscheduled Features

  • Leader reports
    • Home teaching/visiting teaching lists

iOS Regression Test List

See the LDS Tools iOS Test Scripts page

iPhone only tests

iPad only tests

Common tests

This page was last modified on 1 July 2013, at 08:44. This page has been accessed 32,822 times.

Note: Content found in this wiki may not always reflect official Church information. See Terms of Use.