Troubleshooting

This class is not key value coding-compliant for the key XXXX

If you get this error when loading a NIB file it means that the value XXXX was not found on your managed class. This means that you are missing a declaration like this:

[Connect]
TypeName XXXX { 
   get {
       return (TypeName) GetNativeField ("XXXX");
   }
   set {
       SetNativeField ("XXXX", value);
   }
}

The above definition is automatically generated by MonoDevelop for any XIB files that you add to MonoDevelop in the NAME_OF_YOUR_XIB_FILE.designer.xib.cs file.

Additionally, the types containing the above code must be a subclass of NSObject.  If the containing type is within a namespace, it should also have a [Register] attribute which provides a type name without a namespace (as Interface Builder doesn't support namespaces in types):

namespace MonoTouch.Samples.GLPaint {

    // The [Register] attribute overrides the type name registered
    // with the Objective-C runtime, in this case removing the namespace.
    [Register ("AppDelegate")]
    public class AppDelegate {/* ... */}
}

Unknown class XXXX in Interface Builder file

This error is generated if you define a class in your interface builder files but you do not provide the actual implementation for it in your C# code.

You need to add some code like this: 

public partial class MyImageView : UIView {
   public MyImageView (IntPtr handle) : base (handle {}
}

System.MissingMethodException: No constructor found for Foo.Bar::ctor(System.IntPtr)

This error is produced at runtime when the code tries to instantiate an instance of the classes that you referenced from your Interface Builder file.   This means that you forgot to add a constructor that takes a single IntPtr as a parameter.

The constructor with an IntPtr handle is used to bind managed objects with their unmanaged representations.   To fix this, add the following line of code to the class Foo.Bar:

public Bar (IntPtr handle) : base (handle) { }

Type {Foo} does not contain a definition for `GetNativeField' and no extension method `GetNativeField' of type {Foo} could be found

If you get this error in the designer generated files (*.xib.designer.cs), it means one of two things:

1) Missing partial class or base class

The designer-generated partial classes must have corresponding partial classes in user code that inherit from some subclass of NSObject, often UIViewController. Ensure that you have such a class for the type that is giving the error.

2) Default namespaces changed

The designer files are generated using your project's default namespace settings. If you have changed these settings, or renamed the project, the generated partial classes may no longer be in the same namespace as their user-code counterparts.

Namespace settings can be found in the Project Options dialog. The default namespace is found in the General->Main Settings section. If it is blank, the name of your project is used as the default. More advanced namespace settings can be found in the Source Code->.NET Naming Policies section.

Warning for actions: The private method 'Foo' is never used. (CS0169)

Actions for interface builder files are connected to the widgets by reflection at runtime, so this warning is expected.

You can use "#pragma warning disable 0169" "#pragma warning enable 0169" around your actions if you want to suppress this warning just for these methods, or add 0169 to the "Ignore warnings" field in compiler options if you want to disable it for your whole project (not recommended).

mtouch failed with the following message: Cannot open assembly '/path/to/yourproject.exe'

If you see this error message, generally the problem is the absolute path to your project contains a space.  This will be fixed in a future version of MonoTouch, but you can work around the issue by moving the project to a folder without spaces.

Your sqlite3 version is old - please upgrade to at least v3.5.0!

This happens when you do all of the following:

1. Use Mono.Data.Sqlite
2. Use Mac OS X Leopard (10.5)
3. Run your app within the simulator.

The problem is that Mono is picking up the OS X libsqlite3.dylib, not the iPhoneSimulator's libsqlite3.dylib file.  Your app will work on the device, but just not your simulator.

The short term fix is to use Mac OS X Snow Leopard (10.6).  A fix for Leopard (10.5) will be released with a future MonoTouch version.

Deploy to device fails with System.Exception: AMDeviceInstallApplication returned 3892346901

This error means that the code-signing configuration for your certificate/bundle id does not match the provisioning profile installed on your device.  Confirm you have the appropriate certificate selected in Project Options->iPhone Bundle Signing, and the correct bundle id specified in Project Options->iPhone Application

Code Completion is not working in MonoDevelop

Ensure that you are using the latest MonoTouch version of MonoDevelop from http://monodevelop.com/Download/Mac_MonoTouch

If the issue is still present, please file a bug, attaching the "~/.config/MonoDevelop/log" log file.

If all else fails, you can try removing the code completion cache so that it is regenerated:

rm -r ~/.config/MonoDevelop/CodeCompletionData

Be careful that you type this command correctly or you could accidentally remove important files.

MonoDevelop crashes when you copy text

The popular Mac utilities QuickSilver, Google Toolbar and LaunchBar have clipboard features that corrupt MonoDevelop's memory. In their options, you can list MonoDevelop as a process they should not interfere with.

MonoDevelop complains about Mono 2.4 required

If you updated MonoDevelop due to a recent update, and when you try to start it again it complains about Mono 2.4 not being present, all you have to do is upgrade your Mono 2.4 installation.  

Mono 2.4.2.3_6 fixes some important problems that prevented MonoDevelop from running reliably, sometimes hung MonoDevelop at startup or prevented the code completion database from being generated.

Once you install the new Mono, MonoDevelop will start as expected.

Assertion at ../../../../mono/metadata/generic-sharing.c:704, condition `oti' not met

If you are receiving the following stack trace:

 * Assertion at ../../../../mono/metadata/generic-sharing.c:704, condition `oti' not met
Stacktrace:
    at System.Collections.Generic.List`1<object>..cctor () <0xffffffff>
    at System.Collections.Generic.List`1<object>..cctor () <0x0001c>
    at (wrapper runtime-invoke) object.runtime_invoke_dynamic (intptr,intptr,intptr,intptr) <0xffffffff>

It means that you are linking a static library compiled with thumb code into your project.  As of iPhone SDK release 3.1 (or higher at the time of this writing) Apple introduced a bug in their linker when linking non-Thumb code (MonoTouch) with Thumb code (your static library).  You will need to link with a non-Thumb version of your static library to mitigate this issue.

System.ExecutionEngineException: Attempting to JIT compile method (wrapper managed-to-managed) Foo[]:System.Collections.Generic.ICollection`1.get_Count ()

The [] suffix indicates that you or the class library are calling a method on an array through a generic collection, such as IEnumerable<>, ICollection<> or IList<>. As a workaround, you can explicitely force the AOT compiler to include such method by calling the method yourself, and by making sure that this code is executed before the call that triggered the exception. In this case, you could write:

Foo [] array = null;
int count = ((ICollection<Foo>) array).Count;

Which will force the AOT compiler to include the get_Count method.

MonoDevelop source editor is extremely slow

Sometimes the MonoDevelop source editor becomes extremely slow, appearing to hang for several seconds between typing characters.

This issue is very rare and extremely hard to reproduce - it usually cannot be reproduced on the same machine after restarting MonoDevelop. For this reason we would appreciate it if you could perform several debugging steps before restarting MonoDevelop, and send the results to us.

1. Try closing the editor tab, and re-opening it. Does it take a little bit of editing or moving the caret around until the slowdown happens again?
2. Disable "Beam Sync" using the "Quartz Debug" developer tool (which you can find using Spotlight), and check whether the source editor performance is restored to normal.
3. Try repeating step (1) with Beam Sync still disabled.
4. If the editor hangs for more than a few seconds, try to run "killall -QUIT monodevelop" in a terminal while it is hung. It may be difficult to time the kill command to happen while the editor is hung, but it's essential to do so, because the command forces Mono to write stack traces of all threads to the MD log, which we can use to discover what state the threads are in while the MD is hung.

Please attach the MD log, ~/.config/MonoDevelop/log (in future versions of MD it is ~/Library/Logs/MonoDevelop/MonoDevelop.log).

[NOTE: The above issue was fixed in MD 2.2 Final]

Compiled application is very large

In order to support debugging, debug builds contain additional code. Projects built in release mode are a fraction of the size.

As of MonoTouch 1.3 the debug builds included debugging support for every single component of Mono (every method in every class of the frameworks).  

With MonoTouch 1.4 we will introduce a finer grained method for debugging, the default will be to only provide debugging instrumentation for your code and your libraries, and not do this for all of the Mono assemblies (this will still be possible, but you will have to opt-in to debugging those assemblies).

Installation Hangs

Both Mono and MonoTouch installers hang if you have the iPhone Simulator running.   This problem is not limited to Mono or MonoTouch, this is a consistent problem across any software that tries to install software on MacOS Snow Leopard if the iPhone Simulator is running at installation time.

Make sure you quit the iPhone simulator and retry the installation.

Ran out of trampolines of type 0

If you get this message while running device,  You can create more type 0 trampolines (type SPECIFIC) by modifying your project options "iPhone Build" section.  You want to add extra arguments for the Device build targets:

-aot "ntrampolines=2048"

The default number of trampolines is 1024.  Try increasing this number until you have enough for your application.

Ran out of trampolines of type 1

If you make heavy use of recursive generics, you may get this message on device.  You can create more type 1 trampolines (type RGCTX) by modifying your project options "iPhone Build" section.  You want to add extra arguments for the Device build targets:

-aot "nrgctx-trampolines=2048"

The default number of trampolines is 1024.  Try increasing this number until you have enough for your usage of generics.

<Property key="MonoTouch.Debugger.HostIP" value="w.x.y.z"/>

       <key>UIDeviceFamily</key>
       <array>
               <string>1</string>
       </array>

var actionSheet = new UIActionSheet ("My ActionSheet", null, null, "OK", null){     
   Style = UIActionSheetStyle.Default 
}; 
actionSheet.Clicked += delegate (sender, args){ 
    Console.WriteLine ("Clicked on item {0}", args.ButtonIndex); 
};

  at (wrapper managed-to-native) System.Reflection.Assembly.GetTypes (System.Reflection.Assembly,bool)
  at MonoTouch.ObjCRuntime.Runtime.RegisterAssembly (System.Reflection.Assembly) 
  at (wrapper runtime-invoke) <Module>.runtime_invoke_void_object (object,intptr,intptr,intptr)