WandFix

allprojects {
	repositories {
		...
		maven { url 'https://jitpack.io' }
	}
}

annotationProcessor  'com.github.miqt.WandFix:wand-compiler:v1.3.6'
implementation  'com.github.miqt.WandFix:wand:v1.3.6'

// Бinds the proxy class
@BindProxy(clazz = TextActivityProxy.class)
// Must inherit from ProxyActivity
public class TextActivity extends ProxyActivity {
    // Здесь ничего не нужно писать
}

// Каждый прокси-класс должен быть добавлен
@AddToFixPatch
public class TextActivityProxy extends ActivityProxy {
    public TextActivityProxy(ProxyActivity acty) {
        super(acty);
    }

    @Override
    public void onCreate(@Nullable Bundle savedInstanceState) {
        mActy.setContentView(R.layout.activity_hello);
        ...
    }
    
    ...
}

public class MainActivity extends AppCompatActivity implements Wand.MotorListener {
```    ```java
    @InjectObject(
            // full class name
            value = "com.miqt.demo.presenter.AppPresenterImpl",
            // setting parental trust
            // during development it is recommended to use PROJECT, prioritizing the use of local libraries.
            // upon release of the project, it should be changed to NEVER, prioritizing the use of hotfix package libraries.
            level = ParentalEntrustmentLevel.NEVER)
    AppPresenter ap;
    ```    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        // можно инициализировать один раз в application
        Wand.get().init(this).listener(this);
    }

    public void getStr(View view) {
        // использование аннотации для внедрения объекта требует вызова этой строки
        ClassInstall.inject(this);
        // или конструктора с параметрами
        // Map<String, Object[]> paramHouse = new HashMap<>();
        // paramHouse.put("com.miqt.demo.presenter.AppPresenterImpl", new Object[] {"hello"});
        // ClassInstall.inject(this, paramHouse);

        // также можно инициализировать объект без использования аннотации для внедрения
        // ap = ObjectFactory.make("com.miqt.demo.presenter.AppPresenterImpl" /*, параметры конструктора */);
        // ap = ObjectFactory.make(AppPresenterImpl.class /*, параметры конструктора */);

        String str = ap.getStr();
        Toast.makeText(this, str, Toast.LENGTH_SHORT).show();
    }
}

// сначала создайте PluginResources по пути к файлу плагина
// требуется разрешение на чтение/запись файлов
PluginResources manager = new PluginResources(context, pluginApkPath);

// загрузка цветовых ресурсов
int id = manager.getId("text_color", "color");
int color = manager.getResources().getColor(id, context.getTheme());
textView.setTextColor(color);

// загрузка макета
View main_layout = manager.getLayout("activity_main");
```### Описание использования связанных аннотаций и их функций

1. @InjectObject добавьте к членам переменной для внедрения объекта в эту переменную.
2. @AddToFixPatch добавьте к классу без параметров, чтобы указать, что этот класс связан с горячими исправлениями. В процессе компиляции и сборки пакета будут добавлены классы, помеченные этим аннотированием, а также классы, помеченные аннотацией @InjectObject.
3. @BindProxy добавьте к активностям для привязки специального прокси.### Настройка ProGuard

Если проект использует ProGuard, скопируйте следующий код в конфигурационный файл ProGuard:

## Другое
Долгий путь начинается с первого шага, приветствуем ваши вопросы и предложения.

[Как создать и применить пакет горячих исправлений](https://github.com/miqt/WandFix/wiki/Как-создать-и-применить-пакет-горячих-исправлений)

Для получения более подробной информации перейдите на страницу [Wiki](https://github.com/miqt/WandFix/wiki).

Если вам понравился данный проект, то нажмите кнопку "Star" (￣▽￣)*

## Проблемы, возникшие во время разработки и существующие проблемы- [x] При `targetVersion` > 25 активность-прокси не работает (решено)
- [x] При наличии анонимных внутренних классов в пакете горячих исправлений возникает ошибка `java.lang.NoClassDefFoundError` (решено)
- [x] При использовании `findViewById` в активности-прокси иногда контролы не находятся или возникают ошибки преобразования типов (решено)
- [ ] Обработка ProGuard пока недостаточно хороша, поскольку из-за использования рефлексии при активации ProGuard могут возникнуть ошибки `ClassNotFoundException`, но если не использовать ProGuard, защита исходного кода будет недостаточной. Однако у меня есть несколько идей решения этой проблемы, которые еще не были реализованы.
    - [ ] Первый вариант: анализ файла `.app.build.outputs.mapping.debug.mapping.txt` для получения отображения между исходными классами, методами и именами и их зашифрованными версиями, затем поиск соответствующего класса в коде.
    - [ ] Второй вариант: использование шифрования dex, где пакет горячих исправлений фактически представляет собой файл dex, который можно зашифровать с помощью пользовательского алгоритма, тем самым ограничивая возможность декомпиляции.