Nightmare in API 2.0

You can’t partialy deprecate something.

You shouldn’t try to do too much at once. I suggest you have the API1 class and the equivalent API2 class with a slightly different name, in your app at the same time. Then you can move each instance over, one by one. When there are no more instances left of the old class, delete it and do a global name change for the API2 class.

See also: