Ten dokument jest przeznaczony dla programistów, którzy wcześniej rozwidlali Blockly. Planują zaktualizować ją do najnowszej wersji (bez konieczności wprowadzania poprawek w bibliotece). Choć może się to wydawać uciążliwe, jest kilka kroków, które możesz podjąć, by uprościć cały proces.
Informacje o cofaniu
Użycie głównej wersji Blockly oznacza, że używasz niedawno wydanej wersji Blockly, a wszystkie Twoje dostosowania korzystają z publicznych interfejsów API Blockly bez konieczności wykonywania poprawek. Odblokowywanie to praca, którą musisz wykonać, aby zaimplementować niestandardowe funkcje rozwidleń za pomocą głównych interfejsów API.
Proste skrzynie ładunkowe
Poniżej znajdziesz 2 typowe przyczyny rozwidlenia oraz rozwiązania problemu powrotu do wersji głównej:
- Udało Ci się utworzyć własne bloki i generatory bez zmiany kodu Blockly: aby rozciągnąć w tej sytuacji, możesz po prostu przenieść swoje niestandardowe bloki i generatory z repozytorium Blockly do kodu własnej aplikacji. Następnie możesz zaktualizować wersję Blockly.
- Dodałaś niestandardowe funkcje w przestrzeni nazw Blockly bez zmiany kodu Blockly: np. dodałeś pola niestandardowe lub metody pomocnicze używane tylko przez Twoją aplikację. Aby rozszyfrować tę sytuację, przenieś ten niestandardowy kod do swojej aplikacji poza repozytorium Blockly. Powinno być możliwe zaktualizowanie wersji Blockly.
Obszerne cofanie rozwidlenia
Określ rozwidlenie funkcji
Ostatnim powodem, dla którego użytkownicy rozwidają się, jest zastosowanie poprawki Blockly w celu stworzenia niestandardowych funkcji, które ich zdaniem nie są w danej chwili dostępne na poziomie żądania. Jeśli Twój widelec jest znacznie przestarzały, być może mamy już dodane funkcje, których potrzebujesz, jako wtyczki lub jako podstawowe funkcje. Wiedza o tym, jakie funkcje dodałeś do narzędzia, może pomóc Ci opracować plan działań, które trzeba zaktualizować.
Poznaj architekturę
Gdy poznasz już funkcje korzystające z interfejsów API związanych z rozwidleniem, weź pod uwagę te kwestie:
- Czy w przypadku każdej funkcji korzystającej z rozwidlenia jest jakiś sposób na jej odtworzenie za pomocą interfejsów Blockly API?
- Jeśli wydaje Ci się, że nie możesz odtworzyć tej funkcji za pomocą interfejsów Blockly API, skontaktuj się z nami na forum lub zgłoś problem na GitHubie. Nasz zespół sprawdzi dodanie interfejsów API, aby umożliwić dostosowanie reklam.
Określanie ścieżki do cofania
Następnym krokiem jest rozpoczęcie procesu wdrażania nowej architektury Blockly dla funkcji za pomocą rozwidleń. Możesz zastosować jedną z 2 metod:
- Uaktualnij Blockly i sprawdź, co się nie sprawdza: od razu zobaczysz w kodzie obszary, które wymagają aktualizacji. Możesz łączyć to podejście z tym, co już wiesz, czyli niestandardowymi zachowaniami, aby ułatwić sobie programowanie.
- Zrefaktoryzuj kod, aby oddzielić funkcje od Blockly: wymaga to lepszego zrozumienia, które funkcje są niestandardowe w Twoim rozwidleniu, a które pochodzą z Blockly. Po całkowitym odseparowaniu kodu zastąp starszą wersję Blockly najnowszą wersją, a następnie rozwiąż pozostałe problemy z integracją.
Dalsze działania
Oto kilka reguł, których w przyszłości musisz przestrzegać jako deweloper Blockly:
- Z reguły nie dodawaj nowych klas do przestrzeni nazw Blockly. Możesz zarejestrować pola niestandardowe i inne klasy, które można zarejestrować, nie deklarując ich w repozytorium Blockly ani w przestrzeni nazw Blockly.
- Nie należy polegać na narzędziach kompilacji Blockly do skompilowania własnej aplikacji. Nie uważamy naszych narzędzi do kompilacji za część publicznego interfejsu API, dlatego możemy wprowadzić w nich zmiany, które zakłócą działanie Twojej aplikacji. Jeśli chcesz, to Ty odpowiadasz za kompilowanie aplikacji.
Zwróć się o pomoc
Blockly możesz zawsze otworzyć na forum Blockly. Jeśli w trakcie procesu anulowania rozwinięcia pojawią się jakieś problemy, zgłoś je tam, a my pomożemy Ci.